External Interfaces Reference |
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 mxArray
s 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 |
© 1994-2005 The MathWorks, Inc.