Provided by: libmatio-doc_1.5.26-1build3_all bug

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)

Debian                                         September 12, 2019                          MAT_VARWRITEAPPEND(3)