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`