Last modified: 15 August 2013
Name: H5Tenum_create
Signature:
hid_t H5Tenum_create( hid_t dtype_id )

Purpose:
Creates a new enumeration datatype.

Description:
H5Tenum_create creates a new enumeration datatype based on the specified base datatype, dtype_id, which must be an integer datatype.

If a particular architecture datatype is required, a little endian or big endian datatype for example, use a native datatype as the base datatype and use H5Tconvert on values as they are read from or written to a dataset.

Parameters:
hid_t dtype_id     IN: Datatype identifier for the base datatype.
Must be an integer datatype.

Returns:
Returns the datatype identifier for the new enumeration datatype if successful; otherwise returns a negative value.

Fortran90 Interface: h5tenum_create_f
SUBROUTINE h5tenum_create_f(dtype_id, new_type_id, hdferr) 
  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN) :: dtype_id      ! Datatype identifier for
                                              ! the  base datatype
  INTEGER(HID_T), INTENT(OUT) :: new_type_id  ! Datatype identifier for the
                                              ! new enumeration datatype    
  INTEGER, INTENT(OUT) :: hdferr              ! Error code
END SUBROUTINE h5tenum_create_f
    

See Also:
H5Tenum_insert
H5Tenum_valueof
H5Tenum_nameof
H5Tget_member_value
         H5Tconvert
H5Tcreate