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

FreeBSD Manual Pages

  
 
  

home | help
MAT_VARGETSTRUCTS(3)	 BSD 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),

BSD				March 16, 2012				   BSD

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.0-RELEASE+and+Ports>

home | help