External Interfaces/API Reference    
mexGetVariable

Get a copy of a variable from the 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