Creates a new enumeration datatype

Procedure:

H5T_ENUM_CREATE(dtype_id)

Signature:

<pre><code class="language-c">hid_t H5Tenum_create( hid_t dtype_id )</code></pre>

<pre><code class="language-fortran">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</code></pre>

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

Description:

 H5T_ENUM_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 H5T_CONVERT  on values as they are read from or written to a dataset.

Returns:

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

Example:

Coming Soon!