Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MAT_VARGETSTRUCTSLINEAR(3)   Library Functions Manual MAT_VARGETSTRUCTSLINEAR(3)

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 sub-
     array 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)

FreeBSD ports 15.quarterly	 March 14, 2012       MAT_VARGETSTRUCTSLINEAR(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Mat_VarGetStructsLinear&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help