matGetMatrix (External Interfaces/API Reference)

Reads mxArrays from MAT-files

Fortran Syntax

integer*4 function matGetMatrix(mfp, name)
integer*4 mfp
character*(*) name

Arguments
mfp
Pointer to MAT-file information.

name

Name of mxArray to get from MAT-file.

Description

This routine allows you to copy an mxArray out of a MAT-file.

matGetMatrix reads the named mxArray from the MAT-file pointed to by mfp and returns a pointer to a newly allocated mxArray structure, or 0 if the attempt fails.

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

Example

See matdemo1.f in the eng_mat subdirectory of the examples directory for a sample program that illustrates how to use this MAT-file routine in a Fortran program.

matGetFull matGetNextMatrix