matGetNextVariableInfo (External Interfaces/API Reference)

Load array header information only

C Syntax

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

Arguments

mfp
Pointer to MAT-file information.

name
Address of the variable to contain the mxArray name.

Description

matGetNextVariableInfo loads only the array header information, including everything except pr, pi, ir, and jc, from the file's current file offset. MATLAB returns the name of the mxArray in name.

If pr, pi, ir, and jc are set to nonzero values when loaded with matGetVariable, matGetNextVariableInfo sets them to -1 instead. These headers are for informational use only and should never be passed back to MATLAB or saved to MAT-files.

Examples

See matcreat.c and matdgns.c in the eng_mat subdirectory of the examples directory for sample programs that illustrate how to use the MATLAB MAT-file routines in a C program.

matGetNextVariable matGetString (Obsolete)