Синтаксис C

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

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

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

Аргументы

Возвраты

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

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

Описание

matGetNextVariableInfo загружает только информацию о заголовке массива, включая все, кроме pr, pi, ir, и jc, от текущего смещения файла.

Если pr, pi, ir, и jc ненулевые значения при загрузке с matGetVariable, matGetNextVariableInfo устанавливает их на -1 вместо этого. Эти заголовки предназначены только для информационного использования. Никогда не передайте эти данные обратно в MATLAB^® Рабочая область или сохраните его в MAT-файлах.

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

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

Примеры

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

См. также

matGetNextVariable, matGetVariableInfo