matGetVariable (C and Fortran)

Array from MAT-file

C Syntax

#include "mat.h"
mxArray *matGetVariable(MATFile *mfp, const char *name);

Fortran Syntax

#include "mat.h"
mwPointer matGetVariable(mfp, name)
mwPointer mfp
character*(*) name

Arguments

mfp

Pointer to MAT-file information

name

Name of mxArray to get from MAT-file

Returns

Pointer to a newly allocated mxArray structure representing the mxArray named by name from the MAT-file pointed to by mfp.

matGetVariable returns NULL in C (0 in Fortran) if the attempt to return the mxArray named by name fails.

Description

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

Use mxDestroyArray to destroy the mxArray created by this routine when you are finished with it.

Examples

To open an example, type:

edit([fullfile(matlabroot,"extern","examples","engmat","filename")]);

where filename is:

• matcreat.c

• matdemo1.F

Version History

Introduced before R2006a