bionic (3) Mat_VarWriteAppend.3.gz

NAME

     Mat_VarWriteAppend — Writes/appends a MATLAB variable to an HDF5 format MATLAB MAT file.

SYNOPSIS

     #include <matio.h>

     int
     Mat_VarWriteAppend(mat_t *matfp, matvar_t *matvar, enum matio_compression compress, int dim);

DESCRIPTION

     The Mat_VarWriteAppend() function writes (and optionally appends) the MATLAB variable matvar to the MAT
     file matfp which must be opened for writing.  If the MATLAB variable already exists in the MAT file, the
     new data is appended to this variable along the (index 1 based) dimension d.  The compress option allows
     the variable to be written using zlib compression if available.  If compression is not available, the
     variable is written uncompressed.

RETURN VALUES

     The function returns 0 if the variable was successfully written/appended to the MAT file.  Otherwise, an
     error value is returned.

EXAMPLES

     This example program creates a MAT file named by the first argument to the program, and writes the variable
     named m_pi to the file in order to build a 2x1 array.

     #include <math.h>
     #include "matio.h"

     int
     main(int argc,char **argv)
     {
         mat_t    *matfp;
         matvar_t *matvar;
         size_t    dims[2] = {1,1};
         double    m_pi = M_PI;

         matfp = Mat_CreateVer(argv[1],NULL,MAT_FT_MAT73);
         if ( NULL == matfp ) {
             fprintf(stderr,"Error creating MAT file %s0,argv[1]);
             return EXIT_FAILURE;
         }

         matvar = Mat_VarCreate("m_pi",MAT_C_DOUBLE,MAT_T_DOUBLE,2,dims,&m_pi,0);
         if ( NULL != matvar ) {
             int dim = 1;
             Mat_VarWriteAppend(matfp,matvar,MAT_COMPRESSION_ZLIB,dim);
             Mat_VarWriteAppend(matfp,matvar,MAT_COMPRESSION_ZLIB,dim);
             Mat_VarFree(matvar);
         }

         Mat_Close(matfp);
         return EXIT_SUCCESS;
     }

SEE ALSO

     Mat_CreateVer(3), Mat_Open(3), Mat_VarRead(3), Mat_VarWrite(3)