matGetNextVariable (C and Fortran) - Read next mxArray from MAT-file
C Syntax
#include "mat.h"
mxArray *matGetNextVariable(MATFile *mfp, const char **name);
Fortran Syntax
mwPointer matGetNextVariable(mfp, name)
mwPointer mfp
character*(*) name
Arguments
- mfp
Pointer to MAT-file information
- name
Pointer to the variable containing the mxArray name
Returns
Pointer to a newly allocated mxArray structure
representing the next mxArray from the MAT-file
pointed to by mfp. The function returns the name
of the mxArray in name.
matGetNextVariable returns NULL in
C (0 in Fortran) when the end-of-file is reached
or if there is an error condition. In C, use feof and ferror from
the Standard C Library to determine status.
Description
matGetNextVariable allows you to step sequentially
through a MAT-file and read all the mxArrays in
a single pass. The function reads and returns the next mxArray from
the MAT-file pointed to by mfp.
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.
Use mxDestroyArray to destroy the mxArray created
by this routine when you are finished with it.
The order of variables returned from successive calls to matGetNextVariable is
not guaranteed to be the same order in which the variables were written.
C Examples
See matdgns.c
in the matlabroot/extern/examples/eng_mat folder
for sample programs that illustrate how to use the MAT-file routines
in a
C program.
See Also
matGetNextVariableInfo, matGetVariable, mxDestroyArray
 | matGetFp (C) | | matGetNextVariableInfo (C and Fortran) |  |
Includes the most popular MATLAB recorded presentations with Q&A sessions led by MATLAB experts.
Get the Interactive Kit
Store 
