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.