NAME

       Mat_VarGetStructs — Index a structure variable using slices of each dimension

SYNOPSIS

       #include <matio.h>

       matvar_t *
       Mat_VarGetStructs(const matvar_t *matvar, int *start, int *stride, int *edge, int copy_fields);

DESCRIPTION

       The  Mat_VarGetStructs()  function selects a subarray from a structure array matvar. Each of the elements
       in the subarray contains all of the fields of the structure.  The index of each dimension starts  at  the
       start  element  in  the  array  (0 being the first element), and reads every stride values (1 being every
       element, 2 every other element, etc.). The total number of elements in the subarray is specified as edge.
       The copy_fields option specifies whether the fields of the original structure  are  copied  for  the  new
       subarray.   If  set  to  0,  the  returned structure array's fields have the same pointer as the original
       array, and the data field of the subarray structure.  The subarray is marked  with  the  conserve  memory
       flag  indicating  that  the  fields should not be free'd.  They are free'd when the original structure is
       free'd.

RETURN VALUES

       A subarray of the original structure array, or NULL if there is an error.

SEE ALSO

       Mat_VarGetStructsLinear(3)

Debian                                           March 16, 2012                             MAT_VARGETSTRUCTS(3)