NAME¶

Mat_VarGetCells — Gets a subset of elements from a cell array.

SYNOPSIS¶

#include <matio.h>

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

DESCRIPTION¶

The Mat_VarGetCells() function returns an allocated array of pointers to cell elements selected from the cell array matvar using 0-relative per-dimension start coordinates, stride values, and edge lengths. The returned cell elements remain owned by the original cell array. If copies are needed, use Mat_VarDuplicate() on each returned element.

RETURN VALUES¶

On success, an allocated array of cell element pointers is returned. Otherwise NULL is returned. The returned pointer array should be freed by the caller.

SEE ALSO¶

Mat_VarGetCell(3), Mat_VarGetCellsLinear(3)