External Interfaces/API Reference    
matGetNextVariable

Read next mxArray from MAT-file

Fortran Syntax

Arguments

mfp
   Pointer to MAT-file information.

name
   Address of the variable to contain the mxArray name.

Description

matGetNextVariable allows you to step sequentially through a MAT-file and read all the mxArrays in a single pass. The function reads the next mxArray from the MAT-file pointed to by mfp and returns a pointer to a newly allocated mxArray structure. MATLAB returns the name of the mxArray in name.

Use matGetNextVariable immediately after opening the MAT-file with matOpen and not in conjunction with other MAT-file routines. Otherwise, the concept of the next mxArray is undefined.

matGetNextVariable returns 0 when the end-of-file is reached or if there is an error condition.

Be careful in your code to free the mxArray created by this routine when you are finished with it.


  matGetNextMatrix (Obsolete) matGetNextVariableInfo