read

Класс: matlab.io.datastore.DsFileReader
Пакет: matlab.io.datastore

Чтение байтов из файла

Синтаксис

A = read(fr,size)
A = read(fr,size,Name,Value)
[A,count] = read(___)

Описание

A = read(fr,size) возвращает данные из файла, представленного объектом file-reader fr. Количество байтов, заданное в size определяет объем считанных данных.

A = read(fr,size,Name,Value)задает дополнительные параметры, используя один или несколько аргументы пары "имя-значение". Для примера можно задать тип выхода из операции read, которая будет char путем определения 'OutputType','char'.

[A,count] = read(___) возвращает количество байтов данных, фактически считанных read способ.

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

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

Объект программы чтения файлов, заданный как matlab.io.datastore.DsFileReader объект. Как создать DsFileReader объект, см. matlab.io.datastore.DsFileReader.

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

Пример: read(fr,20)

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

Аргументы в виде пар имя-значение

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: 'OutputType','uint8'

Выход данных, заданный как разделенная разделенными запятой парами, состоящая из 'OutputType' и вектор символов или строковый скаляр, содержащий одно из следующих значений: 'uint8', 'int8', 'int16', 'int32', 'int64', 'uint16', 'uint32', 'uint64', 'single', 'double', или 'char'.

Пример: 'OutputType','uint8'

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

Интерпретируйте размер входа, заданный как разделенная разделенными запятой парами, состоящая из 'SizeMethod' и одно из следующих значений:

  • 'NumBytes' - Интерпретируйте size входной параметр как количество байтов для чтения из файла.

  • 'OutputSize' - Интерпретируйте size Входной параметр как размер выхода A из метода read.

Пример: 'SizeMethod','OutputSize'

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

Выходные аргументы

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

Выходные данные, возвращенные как массив.

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

  • Если на 'SizeMethod' Свойство не задано или установлено на 'NumBytes', затем count - количество считанных байтов.

  • Если на 'SizeMethod' для свойства задано значение 'OutputSize', затем count равно size(A).

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

Примеры

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

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

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

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

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

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

Проверьте, есть ли в файле данные для чтения с помощью hasdata способ. Метод read читается 1000 байты из файла и интерпретирует их как символы.

if hasdata(fr)
   [d,count] = read(fr,1000,'OutputType','char');
end

Считайте достаточно байтов из файла, чтобы заполнить 1000 символы путем установки SizeMethod параметр в OutputSize.

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

Введенный в R2017b