Last modified: 29 April 2013
Name: H5Tenum_insert
Signature:
  herr_t `H5Tenum_insert`( hid_t `dtype_id`, const char *`name`, void *`value` )

Purpose:
  Inserts a new enumeration datatype member.

Description:
  `H5Tenum_insert` inserts a new enumeration datatype member into an enumeration datatype.

  `dtype_id` is the datatype identifier for the enumeration datatype, `name` is the name of the new member, and `value` points to the value of the new member.

  `name` and `value` must both be unique within `dtype_id`.

  `value` points to data which must be of the integer base datatype used when the enumeration datatype was created. 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 enumeration datatype.
const char *`name` | IN: Name of the new member.
void *`value` | IN: Pointer to the value of the new member.

Returns:
  Returns a non-negative value if successful; otherwise returns a negative value.

Fortran90 Interface: h5tenum_insert_f

      SUBROUTINE h5tenum_insert_f(type_id,  name, value, hdferr)
        IMPLICIT NONE
        INTEGER(HID_T), INTENT(IN) :: type_id ! Datatype identifier
        CHARACTER(LEN=*), INTENT(IN) :: name  ! Name of the new member
        INTEGER, INTENT(IN) :: value          ! Value of the new member
        INTEGER, INTENT(OUT) :: hdferr        ! Error code
      END SUBROUTINE h5tenum_insert_f

See Also:
  `H5Tenum_create`
  `H5Tenum_valueof`
  `H5Tenum_nameof`
  `H5Tget_member_value`
  `H5Tconvert`