Last modified: 23 April 2013
Name: H5Tenum_nameof
Signature:
herr_t H5Tenum_nameof( hid_t dtype_id, void *value, char *name, size_t size )

Purpose:
Returns the symbol name corresponding to a specified member of an enumeration datatype.

Description:
H5Tenum_nameof finds the symbol name that corresponds to the specified value of the enumeration datatype dtype_id.

At most size characters of the symbol name are copied into the name buffer. If the entire symbol name and null terminator do not fit in the name buffer, then as many characters as possible are copied (not null terminated) and the function fails.

Parameters:

Returns:
Returns a non-negative value if successful. Otherwise returns a negative value and, if size allows it, the first character of name is set to NULL.

Fortran90 Interface: h5tenum_nameof_f
SUBROUTINE h5tenum_nameof_f(type_id, value, namelen, name, hdferr) 
  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN) :: type_id  ! Datatype identifier 
  INTEGER, INTENT(IN) :: value           ! Value of the enumeration datatype
  INTEGER(SIZE_T), INTENT(IN) :: namelen ! Length of the name
  CHARACTER(LEN=*), INTENT(OUT) :: name  ! Name of the enumeration datatype
  INTEGER, INTENT(OUT) :: hdferr         ! Error code
END SUBROUTINE h5tenum_nameof_f
	

See Also:
H5Tenum_create
H5Tenum_insert
H5Tenum_valueof
H5Tget_member_value
H5Tconvert