matPutVariable (C and Fortran) - Array to MAT-file

C Syntax

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

Fortran Syntax

integer*4 matPutVariable(mfp, name, pm)
mwPointer mfp, pm
character*(*) name

Arguments

mfp

Pointer to MAT-file information

name

Name of mxArray to put into MAT-file

pm

mxArray pointer

Returns

0 if successful and nonzero if an error occurs. In C, use feof and ferror from the Standard C Library along with matGetFp to determine status.

Description

This routine puts an mxArray into a MAT-file.

matPutVariable writes mxArray pm to the MAT-file mfp. If the mxArray does not exist in the MAT-file, the function appends it to the end. If an mxArray with the same name exists in the file, the function replaces the existing mxArray with the new mxArray by rewriting the file.

Do not use MATLAB function names for variable names. Common variable names that conflict with function names include i, j, mode, char, size, or path. To determine whether a particular name is associated with a MATLAB function, use the which function.

The size of the new mxArray can be different from the existing mxArray.

Examples

See the following examples in matlabroot/extern/examples/eng_mat.

• matcreat.c

See Also

matGetVariable, matGetFp

Recommended Products

• MATLAB
• Signal Processing Toolbox
• Optimization Toolbox
• Statistics Toolbox
• Control System Toolbox

Get MATLAB trial software

Includes the most popular MATLAB recorded presentations with Q&A sessions led by MATLAB experts.

Get the Interactive Kit