Retrieves the name of a compound or enumeration datatype member


H5T_GET_MEMBER_NAME (dtype_id, field_idx)


<pre><code class="language-c">char * H5Tget_member_name( hid_t dtype_id, unsigned field_idx )</code></pre>

<pre><code class="language-fortran">SUBROUTINE h5tget_member_name_f(type_id,index, member_name,  namelen, hdferr) 
  INTEGER(HID_T), INTENT(IN) :: type_id        ! Datatype identifier 
  INTEGER, INTENT(IN) :: index                 ! Field index (0-based) of 
                                               ! the field name to retrieve 
  CHARACTER(LEN=*), INTENT(OUT) :: member_name ! Name of a field of
                                               ! a compound datatype 
  INTEGER, INTENT(OUT) :: namelen              ! Length of the name 
  INTEGER, INTENT(OUT) :: hdferr               ! Error code
END SUBROUTINE h5tget_member_name_f</code></pre>

hid_t tdype_idIN: Identifier of datatype to query
unsigned field_idx   IN: Zero-based index of the field or element whose name is to be retrieved


H5T_GET_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 field_idx. 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 H5T_GET_NMEMBERS. 

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


Returns a valid pointer to a string allocated with malloc() if successful; otherwise returns NULL.


Coming Soon!

Release    Change
1.6.4field_idx parameter type changed to unsigned.