MATLAB®

matGetVariable (C and Fortran) - Read mxArray from MAT-files

C Syntax

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

Fortran Syntax

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

A 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.

C Examples

See matcreat.c and matdgns.c in the eng_mat subdirectory of the examples directory for sample programs that illustrate how to use the MATLAB^® MAT-file routines in a C program.

See Also

matPutVariable, mxDestroyArray

matGetNextVariableInfo (C and Fortran)

matGetVariableInfo (C and Fortran)