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

FreeBSD Manual Pages

  
 
  

home | help
MAT_VARGETSTRUCTS(3)   FreeBSD Library Functions Manual	  MAT_VARGETSTRUCTS(3)

NAME
     Mat_VarGetStructs -- Index	a structure variable using slices of each di-
     mension

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 ar-
     ray 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)

FreeBSD	13.0			March 16, 2012			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Mat_VarGetStructs&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help