MAT_VARWRITEAPPEND(3)      Library Functions Manual      MAT_VARWRITEAPPEND(3)

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)

Linux 6.11.5-arch1-1          September 12, 2019          Linux 6.11.5-arch1-1