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-битный знаковый символ.

По умолчанию точность — "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.

: count = fwrite (fid, data) ¶

: count = fwrite (fid, data, precision) ¶

: count = fwrite (fid, data, precision, skip) ¶

: count = fwrite (fid, data, precision, skip, arch) ¶

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

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

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

Выходной count — количество успешно записанных элементов данных.

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

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