matGetNextVariable (C и Фортран)

Следующий массив в 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 не определена.

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

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

Примеры

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

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

Для просмотра документации необходимо авторизоваться на сайте