External Interfaces Reference |
Get copy of variable from specified workspace
C Syntax
Arguments
workspace
Specifies where mexGetVariable
should search in order to find array, var_name
. The possible values are
base |
Search for the variable in the base workspace |
caller |
Search for the variable in the caller's workspace |
global |
Search for the variable in the global workspace |
var_name
Name of the variable to copy.
Returns
A copy of the variable on success. Returns NULL
on failure. A common cause of failure is specifying a variable that is not currently in the workspace. Perhaps the variable was in the workspace at one time but has since been cleared.
Description
Call mexGetVariable
to get a copy of the specified variable. The returned mxArray
contains a copy of all the data and characteristics that the variable had in the other workspace. Modifications to the returned mxArray
do not affect the variable in the workspace unless you write the copy back to the workspace with mexPutVariable
.
Examples
See mexgetarray.c
in the mex
subdirectory of the examples
directory.
See Also
mexGetVariablePtr
, mexPutVariable
mexGetNaN (Obsolete) | mexGetVariablePtr |
© 1994-2005 The MathWorks, Inc.