Синтаксис C

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

Синтаксис Фортрана

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

Аргументы

Прибыль

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

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

Описание

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

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

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

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

Примеры

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

См. также

matGetNextVariableInfo, matGetVariable, mxDestroyArray