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:

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