Please, help us to better serve our user community by answering the following short survey: https://www.hdfgroup.org/website-survey/
HDF5  1.14.4.3
API Reference
 
Loading...
Searching...
No Matches
Compound and Enumeration Datatypes

Detailed Description

Modules

 Compound Datatypes
 
 Enumeration Datatypes
 

Functions

int H5Tget_nmembers (hid_t type_id)
 Retrieves the number of elements in a compound or enumeration datatype.
 
char * H5Tget_member_name (hid_t type_id, unsigned membno)
 Retrieves the name of a compound or enumeration datatype member.
 
int H5Tget_member_index (hid_t type_id, const char *name)
 Retrieves the index of a compound or enumeration datatype member.
 

Function Documentation

◆ H5Tget_member_index()

int H5Tget_member_index ( hid_t  type_id,
const char *  name 
)

Retrieves the index of a compound or enumeration datatype member.

Parameters
[in]type_idDatatype identifier
[in]nameName of the field or member
Returns
Returns a non-negative value if successful; otherwise, returns a negative value.

H5Tget_member_index() retrieves the index of a field of a compound datatype or an element of an enumeration datatype.

The name of the target field or element is specified by name.

Fields are stored in no particular order with index values of 0 through N-1, where N is the value returned by H5Tget_nmembers() .

Since
1.4.0

◆ H5Tget_member_name()

char * H5Tget_member_name ( hid_t  type_id,
unsigned  membno 
)

Retrieves the name of a compound or enumeration datatype member.

Parameters
[in]type_idDatatype identifier
[in]membnoZero-based index of the field or element
Returns
Returns a valid pointer to a string allocated with malloc() if successful; otherwise returns NULL.

H5Tget_member_name() retrieves the name of a field of a compound datatype or an element of an enumeration datatype.

The index of the target field or element is specified in member_no. Compound datatype fields and enumeration datatype elements are stored in no particular order with index values of 0 through N-1, where N is the value returned by H5Tget_nmembers().

The HDF5 library allocates a buffer to receive the name of the field. The caller must subsequently free the buffer with H5free_memory().

Since
1.0.0

◆ H5Tget_nmembers()

int H5Tget_nmembers ( hid_t  type_id)

Retrieves the number of elements in a compound or enumeration datatype.

Parameters
[in]type_idDatatype identifier
Returns
Returns the number of elements if successful; otherwise returns a negative value.

H5Tget_nmembers() retrieves the number of fields in a compound datatype or the number of members of an enumeration datatype.

Since
1.0.0