matlab.io.datastore.DsFileReader class

Пакет: matlab.io.datastore

Объект программы чтения файлов для файлов в datastore

Описание

The DsFileReader объект включает низкоуровневый доступ для чтения файлов в datastore.

Конструкция

fr = matlab.io.datastore.DsFileReader(filename) возвращает DsFileReader объект для доступа для чтения к файлу, заданному filename.

fr = matlab.io.datastore.DsFileReader(filename,'TextEncoding',encoding) задает схему символьного кодирования, сопоставленную с файлом. Кроме того, установка encoding устанавливает TextEncoding свойство DsFileReader объект.

Входные параметры

расширить все

Имя файла, включая расширение файла, задается как вектор символов или строковый скаляр. Если файл отсутствует в текущей папке, filename должен включать полный или относительный путь.

The Name свойство DsFileReader объект хранит имя файла.

Пример: 'myFile.txt'

Типы данных: char | string

Схема кодирования символов, сопоставленная с файлом, задается как имя стандартной схемы кодирования символов, перечисленной в этой таблице.

'Big5'

'ISO-8859-1'

'windows-847'

'Big5-HKSCS'

'ISO-8859-2'

'windows-949'

'CP949'

'ISO-8859-3'

'windows-1250'

'EUC-KR'

'ISO-8859-4'

'windows-1251'

'EUC-JP'

'ISO-8859-5'

'windows-1252'

'EUC-TW'

'ISO-8859-6'

'windows-1253'

'GB18030'

'ISO-8859-7'

'windows-1254'

'GB2312'

'ISO-8859-8'

'windows-1255'

'GBK'

'ISO-8859-9'

'windows-1256'

'IBM866'

'ISO-8859-11'

'windows-1257'

'KOI8-R'

'ISO-8859-13'

'windows-1258'

'KOI8-U'

'ISO-8859-15'

'US-ASCII'

 

'Macintosh'

'UTF-8'

 

'Shift_JIS'

 

The TextEncoding свойство DsFileReader объект сохраняет значение, заданное в encoding.

Пример: 'Shift_JIS'

Типы данных: char | string

Свойства

расширить все

Имя файла, заданное как вектор символов или строковый скаляр.

Пример: fr.Name возвращает имя файла.

Типы данных: char | string

Размер файла в байтах, возвращенный как числовой скаляр целое число.

Пример: fr.Size

Типы данных: double

Схема кодирования символов, сопоставленная с файлом, задается как имя стандартной схемы кодирования символов. Чтобы задать значение для TextEncoding свойство, см. описание encoding входной параметр.

Пример: 'TextEncoding','Shift_JIS'

Положение указателя в файле, заданное как целое число. Указатель положения является нулевым целым числом, которое отслеживает количество байтов от начала файла.

Если файл имеет n байты данных, а затем те n байты находятся в положениях 0 через n-1.

Можно задать Position свойство с использованием seek способ. Вызовы на read метод начинает чтение файла из местоположения, указанного Position свойство. При итерационном чтении файла read метод автоматически обновляет указатель положения. Последующие вызовы read метод начинает считывать из конечного положения предыдущей операции считывания.

Типы данных: double

Методы

hasdata Определите, доступны ли данные для чтения
read Чтение байтов из файла
seek Поиск положения в файле

Примеры

Чтение фрагмента файла, заданной начальной позицией и размером

Создайте объект программы чтения файлов для файла, поищите нужное начальное положение и прочитайте фрагмент файла.

Создайте DsFileReader объект для airlinesmall.csv.

fr = matlab.io.datastore.DsFileReader('airlinesmall.csv');

The airlinesmall.csv файл имеет имена переменных в начале файла. Линия имен переменных заканчивается в положении, отмеченном 299 байты. Чтобы пройти мимо линии имен переменных, используйте seek метод для перемещения считываемого указателя в начальное положение.

seek(fr,299,'RespectTextEncoding',true);

Прочтите первое 1000 персонажи.

 if hasdata(fr)
    d = read(fr,1000,'SizeMethod','OutputSize','OutputType','char');
 end

Введенный в R2017b