Put variable into MATLAB engine workspace
#include "engine.h" int engPutVariable(Engine *ep, const char *name, const mxArray *pm);
pm to the engine
ep, giving it the variable name
0 if successful and
1 if an error occurs.
mxArray does not exist in the workspace, the function
creates it. If an
mxArray with the same name exists in the workspace,
the function replaces the existing
mxArray with the new
The limit for the size of data transferred is 2 GB.
Do not use MATLAB® function names for variable names.
Common variable names that conflict with function names include
To determine whether a particular name is associated with a MATLAB function,
The engine application owns the original
mxArray and is responsible
for freeing its memory. Although the
engPutVariable function sends
a copy of the
mxArray to the MATLAB workspace, the engine application does not need to account for or free
memory for the copy.
ep— Pointer to engine
Pointer to engine, specified as
name— Name of mxArray
const char *
mxArray in the MATLAB workspace, specified as
pm— Pointer to mxArray
const mxArray *
Pointer to mxArray, specified as
See these examples in