matGetNextVariable (C and Fortran)

Следующий массив в MAT-файле

Синтаксис C

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

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

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

Аргументы

mfp

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

name

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

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

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

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

Описание

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

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

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

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

Примеры

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

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