matGetArray (MATLAB Application Program Interface)

Read mxArrays from MAT-files

C Syntax

#include "mat.h"
mxArray *matGetArray(MATFile *mfp, const char *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.

matGetArray reads the named mxArray from the MAT-file pointed to by mfp and returns a pointer to a newly allocated mxArray structure, or NULL 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 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.

[ Previous | Help Desk | Next ]