exponenta event banner

matGetVariableInfo (C и Fortran)

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

Синтаксис C

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

Синтаксис Фортрана

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

Аргументы

mfp

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

name

Наименование mxArray для получения из MAT-файла

Прибыль

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

matGetVariableInfo прибыль NULL в C (0 в Fortran), если попытка вернуть информацию заголовка для mxArray по имени name не удается.

Описание

matGetVariableInfo загружает только информацию заголовка массива, включая все, кроме pr, pi, ir, и jc. Он рекурсивно создает ячейки и структуры через их листовые элементы, но не включает pr, pi, ir, и jc.

Если pr, pi, ir, и jc являются ненулевыми значениями при загрузке с matGetVariable, matGetVariableInfo устанавливает для них значение -1 вместо этого. Эти заголовки предназначены только для информационного использования. Никогда не передавайте эти данные обратно в рабочую область MATLAB ® и не сохраняйте их в MAT-файлах.

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

Примеры

См. эти примеры в разделе matlabroot/extern/examples/eng_mat:

См. также

matGetVariable

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