Синтаксис 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