matGetNextVariable (C and Fortran)

Следующий массив в MAT-файле

Синтаксис C

#include "mat.h"
mxArray *matGetNextVariable(MATFile *mfp, const char **name);

Синтаксис языка ФОРТРАН

#include "mat.h"
mwPointer matGetNextVariable(mfp, name)
mwPointer mfp
character*(*) name

Аргументы

mfp

Указатель на информацию MAT-файла

name

Указатель на переменную, содержащую mxArray имя

Возвраты

Указатель на недавно выделенный mxArray структура, представляющая следующую mxArray из MAT-файла, на который указывает mfp. Функция возвращает имя mxArray в name.

matGetNextVariable возвращает NULL в C (0 на языке Фортран) для конца файла или при наличии условия ошибки. На C используйте feof и ferror в стандартной библиотеке C для определения статуса.

Описание

matGetNextVariable позволяет последовательно проходить через MAT-файл и читать каждую mxArray одним паролем. Функция читает и возвращает следующую mxArray из MAT-файла, на который указывает mfp.

Использовать matGetNextVariable сразу после открытия MAT-файла с matOpen а не с другими стандартными программами MAT-файлов. В противном случае концепция следующего mxArray не определено.

Использовать mxDestroyArray чтобы уничтожить mxArray созданный этой стандартной программой, когда вы закончите с ней.

Порядок переменных, возвращенных из последовательных вызовов в matGetNextVariable не гарантировано быть таким же порядком, в котором были записаны переменные.

Примеры

См. эти примеры в matlabroot/ extern/examples/eng_mat:

Представлено до R2006a