engGetArray (External Interfaces/API Reference)

Copy a variable from a MATLAB engine's workspace

C Syntax

#include "engine.h"
mxArray *engGetArray(Engine *ep, const char *name);

Arguments
ep
Engine pointer.

name

Name of mxArray to get from engine.

Description

engGetArray reads the named mxArray from the engine pointed to by ep and returns a pointer to a newly allocated mxArray structure, or NULL if the attempt fails. engGetArray will fail if:

The named variable does not exist.

In V4-compatible mode if the named variable is not a MATLAB 4 data type.

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

Example

UNIX

See engdemo.c in the eng_mat subdirectory of the examples directory for a sample program that illustrates how to call the MATLAB engine functions from a C program.

Windows

See engwindemo.c in the eng_mat subdirectory of the examples directory for a sample program that illustrates how to call the MATLAB engine functions from a C program for Windows.

See Also

engPutArray

engEvalString engGetFull (Obsolete)