matOpen (C and Fortran)

Open MAT-file

C Syntax

#include "mat.h"
MATFile *matOpen(const char *filename, const char *mode);

#include "mat.h"
mwPointer matOpen(filename, mode)
character*(*) filename, mode

filename

Name of file to open

mode

File opening mode. The following table lists valid values for mode.

`r`	Opens file for reading only; determines the current version of the MAT-file by inspecting the files and preserves the current version.
`u`	Opens file for update, both reading and writing. If the file does not exist, does not create a file (equivalent to the `r+` mode of `fopen`). Determines the current version of the MAT-file by inspecting the files and preserves the current version.
`w`	Opens file for writing only; deletes previous contents, if any.
`w4`	Creates a MAT-file compatible with MATLAB^® Versions 4 software and earlier.
`w6`	Creates a MAT-file compatible with MATLAB Version 5 (R8) software or earlier. Equivalent to `wL` mode.
`wL`	Opens file for writing character data using the default character set for your system. Use MATLAB Version 6 or 6.5 software to read the resulting MAT-file. If you do not use the `wL` mode switch, MATLAB writes character data to the MAT-file using Unicode^® character encoding by default. Equivalent to `w6` mode.
`w7`	Creates a MAT-file compatible with MATLAB Version 7.0 (R14) software or earlier. Equivalent to `wz` mode.
`wz`	Opens file for writing compressed data. By default, the MATLAB `save` function compresses workspace variables as they are saved to a MAT-file. To use the same compression ratio when creating a MAT-file with the `matOpen` function, use the `wz` option. Equivalent to `w7` mode.
`w7.3`	Creates a MAT-file in an HDF5-based format that can store objects that occupy more than 2 GB.

File handle, or NULL in C (0 in Fortran) if the open fails.

This routine opens a MAT-file for reading and writing.

See these examples in matlabroot/extern/examples/eng_mat: