External Interfaces Reference |
Put mxArray
s into MAT-files as originating from global workspace
C Syntax
Arguments
mfp
Pointer to MAT-file information.
name
Name of mxArray
to put into MAT-file.
Description
This routine allows you to put an mxArray
into a MAT-file. matPutVariableAsGlobal
is similar to matPutVariable
, except the array, when loaded by MATLAB, is placed into the global workspace and a reference to it is set in the local workspace. If you write to a MATLAB 4 format file, matPutVariableAsGlobal
will not load it as global, and will act the same as matPutVariable
.
matPutVariableAsGlobal
writes mxArray
mp
to the MAT-file mfp
. If the mxArray
does not exist in the MAT-file, it is appended to the end. If an mxArray
with the same name already exists in the file, the existing mxArray
is replaced with the new mxArray
by rewriting the file. The size of the new mxArray
can be different than the existing mxArray
.
matPutVariableAsGlobal
returns 0
if successful and nonzero if an error occurs. Use feof
and ferror
from the Standard C Library with matGetFp
to determine status.
Examples
See matcreat.c
and matdgns.c
in the eng_mat
subdirectory of the examples
directory for sample programs that illustrate how to use the MATLAB MAT-file routines in a C program.
matPutVariable | C MX-Functions |
© 1994-2005 The MathWorks, Inc.