NAME

     Mat_VarGetStructsLinear — Linearly index a structure variable

SYNOPSIS

     #include <matio.h>

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

DESCRIPTION

     The Mat_VarGetStructsLinear() 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
     indexing 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 original array must have at least
     start+(stride-1)*edge+1 elements. 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_VarGetStructs(3),