Last modified: 30 September 2010
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 enumeration datatype’s base datatype, name is the name of the new member, and value points to the value of the new member.

dtype_id must be a native 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.

name and value must both be unique within dtype_id.

value points to data which is of the datatype defined when the enumeration datatype was created.

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