External Interfaces/API Reference

engGetVariable

Copy a variable from a MATLAB engine's workspace

C Syntax

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

Arguments

ep
   Engine pointer.

name
   Name of mxArray to get from MATLAB.

Description

engGetVariable reads the named mxArray from the MATLAB engine session associated with ep and returns a pointer to a newly allocated mxArray structure, or NULL if the attempt fails. engGetVariable fails if the named variable does not exist.

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

Examples

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

engPutVariable

engGetMatrix (Obsolete)

engGetVisible