Следующий массив в MAT-файле
#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
не определена.
Используйте mxDestroyArray
, чтобы уничтожить mxArray
, созданный этой стандартной программой, когда вы будете закончены с ним.
Порядок переменных, возвращенных от последовательных вызовов до matGetNextVariable
, как гарантируют, не будет тем же порядком, в котором были написаны переменные.