Mat_CreateVer man page

Mat_CreateVer, Mat_Create — Create a MATLAB .mat file

Synopsis

#include <matio.h>

mat_t *
Mat_CreateVer(const char *matname, const char *hdr_str, enum mat_ft mat_file_ver);

mat_t *
Mat_Create(const char *matname, const char *hdr_str);

Description

The Mat_CreateVer() function creates a MATLAB .mat file opened for write access. The hdr_str is a string written in the file header of MAT version 5 and 7.3 (HDF) files. Only the first 128 bytes of the string is written. If hdr_str is NULL, then a default string is written that contains the platform, date, matio library version.

The mat_file_ver argument specifies the MAT file version to create. The matio library can write version 5 files (MAT_FT_MAT5), and an HDF5 file format introduced in MATLAB version 7.3 (MAT_FT_MAT73).

The Mat_Create() function is equivalent to calling Mat_CreateVer() with MAT_FT_DEFAULT as the file version.

Examples

#include <stdlib.h> 
#include <stdio.h> 
#include "matio.h" 
 
int main(int argc,char **argv) 
{ 
    mat_t *matfp; 
 
    matfp = Mat_CreateVer(argv[1],NULL,MAT_FT_73); 
    if ( NULL == matfp ) { 
        fprintf(stderr,"Error creating MAT file %s0,argv[1]); 
        return EXIT_FAILURE; 
    } 
 
    Mat_Close(matfp); 
    return EXIT_SUCCESS; 
} 

See Also

Mat_Create(3), Mat_CreateVer(3), Mat_Close(3)

Referenced By

Mat_Close(3), Mat_GetFilename(3), Mat_GetVersion(3), Mat_Open(3), Mat_VarWrite(3).

April 21, 2011