14.2.16 Бинарный ввод/вывод

Octave может читать и записывать двоичные данные с помощью функций fread и fwrite, которые основаны на стандартных функциях C с такими же именами. Они могут автоматически менять порядок байтов для целочисленных данных и преобразовывать между поддерживаемыми форматами чисел с плавающей точкой при чтении данных.

val = fread (fid)

val = fread (fid, size)

val = fread (fid, size, precision)

val = fread (fid, size, precision, skip)

val = fread (fid, size, precision, skip, arch)

[val, count] = fread (…)

Считывает двоичные данные из файла, указанного дескриптором файла fid.

Необязательный аргумент size определяет количество считываемых данных и может быть одним из

Inf

Считывает как можно больше, возвращая вектор-столбец.

nr

Считывает до nr элементов, возвращая вектор-столбец.

[nr, Inf]

Считывает как можно больше, возвращая матрицу с nr строками. Если количество считанных элементов не является точным кратным nr, последняя колонка заполняется нулями.

[nr, nc]

Считывает до nr * nc элементов, возвращая матрицу с nr строками. Если количество считанных элементов не является точным кратным nr, последняя колонка заполняется нулями.

Если size опущен, используется значение Inf.

Необязательный аргумент precision — это строка, определяющая тип считываемых данных, и может быть одним из

"uint8" (по умолчанию)

8-битное беззнаковое целое число.

"int8"

"integer*1"

8-битное знаковое целое число.

"uint16"

"ushort"

"unsigned short"

16-битное беззнаковое целое число.

"int16"

"integer*2"

"short"

16-битное знаковое целое число.

"uint"

"uint32"

"unsigned int"

"ulong"

"unsigned long"

32-битное беззнаковое целое число.

"int"

"int32"

"integer*4"

"long"

32-битное знаковое целое число.

"uint64"

64-битное беззнаковое целое число.

"int64"

"integer*8"

64-битное знаковое целое число.

"single"

"float"

"float32"

"real*4"

32-битное число с плавающей точкой.

"double"

"float64"

"real*8"

64-битное число с плавающей точкой.

"char"

"char*1"

8-битный одиночный символ.

"uchar"

"unsigned char"

8-битный беззнаковый символ.

"schar"

"signed char"

8-битный знаковый символ.

Значение по умолчанию для precision — "uint8".

Аргумент precision также может указывать необязательный счётчик повторений. Например, ‘32*single’ заставляет fread считывать блок из 32 чисел с плавающей точкой одинарной точности. Чтение блоками полезно в сочетании с аргументом skip.

Аргумент precision также может указывать преобразование типа. Например, ‘int16=>int32’ заставляет fread считывать значения 16-битных целых чисел и возвращать массив 32-битных целых чисел. По умолчанию fread возвращает массив двойной точности. Специальная форма ‘*TYPE’ является сокращением для ‘TYPE=>TYPE’.

Преобразование и счётчик повторений можно объединить. Например, спецификация ‘32*single=>single’ заставляет fread считывать блоки чисел с плавающей точкой одинарной точности и возвращать массив чисел одинарной точности вместо массива чисел двойной точности по умолчанию.

Необязательный аргумент skip определяет количество байтов, которые нужно пропустить после считывания каждого элемента (или блока элементов). Если он не указан, используется значение 0. Если последний считанный блок не полный, окончательный skip опускается. Например,

fread (f, 10, "3*single=>single", 8)

опустит конечный 8-байтовый skip, потому что последнее чтение не будет полным блоком из 3 значений.

Необязательный аргумент arch — это строка, определяющая формат данных для файла. Допустимые значения:

"native" или "n"

Формат текущей машины.

"ieee-be" или "b"

IEEE big endian.

"ieee-le" или "l"

IEEE little endian.

Если arch не указан, используется значение, используемое при вызове fopen, который создал дескриптор файла. В противном случае, значение, указанное с fread, переопределяет значение fopen и определяет формат данных.

Выходной аргумент val содержит данные, считанные из файла.

Необязательное возвращаемое значение count содержит количество прочитанных элементов.

См. также: fwrite, fgets, fgetl, fscanf, fopen.

fwrite (fid, data)

fwrite (fid, data, precision)

fwrite (fid, data, precision, skip)

fwrite (fid, data, precision, skip, arch)

count = fwrite (…)

Записывает данные в двоичном формате в файл, указанный дескриптором файла fid, возвращая количество успешно записанных значений count в файл.

Аргумент data — это матрица значений, которые нужно записать в файл. Значения извлекаются в порядке следования столбцов.

Остальные аргументы precision, skip и arch необязательны и интерпретируются так же, как описано для fread.

Поведение fwrite не определено, если значения в data слишком велики для указанного типа.

См. также: fread, fputs, fprintf, fopen.