DragonFly On-Line Manual Pages

Search: Section:  


MAT_VARREAD(3)        DragonFly Library Functions Manual        MAT_VARREAD(3)

NAME

Mat_VarRead - Reads the information and data for a specific variable in a MATLAB MAT file.

SYNOPSIS

#include <matio.h> matvar_t * Mat_VarRead(mat_t *mat, const char *name);

DESCRIPTION

The Mat_VarRead() function reads the information and data for the variable name in the open MAT file.

RETURN VALUES

If the variable was found in the MAT file and successfully read, a pointer to the MATLAB variable structure is returned. If the variable was not found, or there was an error reading the variable, NULL is returned.

EXAMPLES

This example program opens a MAT file named by the first argument to the program, and reads a variable named x from the file. The MATIO function Mat_VarPrint is used to print the information and data from the file. #include "matio.h" int main(int argc,char **argv) { mat_t *matfp; matvar_t *matvar; matfp = Mat_Open(argv[1],MAT_ACC_RDONLY); if ( NULL == matfp ) { fprintf(stderr,"Error opening MAT file %s0,argv[1]); return EXIT_FAILURE; } matvar = Mat_VarRead(matfp,"x"); if ( NULL != matvar ) { Mat_VarPrint(matvar); Mat_VarFree(matvar); } Mat_Close(matfp); return EXIT_SUCCESS; }

SEE ALSO

Mat_VarReadInfo(3), Mat_VarReadNext(3), Mat_VarPrint(3) DragonFly 5.7-DEVELOPMENT April 21, 2011 DragonFly 5.7-DEVELOPMENT

Search: Section: