Синтаксис 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 в Fortran) при достижении конца файла или при возникновении ошибки. В C, использование feof и ferror из библиотеки Standard 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