matGetVariable (C and Fortran) - Array from MAT-file

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

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

See the following examples in matlabroot/extern/examples/eng_mat.

• matcreat.c

See Also

matPutVariable, mxDestroyArray

Recommended Products

• MATLAB
• Signal Processing Toolbox
• Optimization Toolbox
• Statistics Toolbox
• Control System Toolbox

Get MATLAB trial software

Includes the most popular MATLAB recorded presentations with Q&A sessions led by MATLAB experts.

Get the Interactive Kit