Mat_VarGetStructs(3) Library Functions Manual Mat_VarGetStructs(3)
NAME
Mat_VarGetStructs - Index a structure variable using slices of each
dimension
SYNOPSIS
#include <matio.h>
matvar_t *
Mat_VarGetStructs(const matvar_t *matvar, cons int *start,
const int *stride, const 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)
macOS 13.6 November 20, 2023 macOS 13.6
matio 1.5.27 - Generated Sun Apr 21 06:41:52 CDT 2024