External Interfaces/API Reference

matPutVariable

Write mxArrays into MAT-files

C Syntax

• #include "mat.h"
  int matPutVariable(MATFile *mfp, const char *name, const mxArray 
  *mp);
  

Arguments

mfp
   Pointer to MAT-file information.

name
   Name of mxArray to put into MAT-file.

mp
   mxArray pointer.

Description

This routine allows you to put an mxArray into a MAT-file.

matPutVariable 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.

matPutVariable returns 0 if successful and nonzero if an error occurs. Use feof and ferror from the Standard C Library along 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.

matPutString (Obsolete)

matPutVariableAsGlobal