matGetNextVariableInfo (C and Fortran)

Информация о заголовке массивов только

Синтаксис C

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

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

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

Аргументы

mfp

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

name

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

Возвращается

Указатель на недавно выделенный 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

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