Inserts a new enumeration datatype member
Procedure:
H5T_ENUM_INSERT(dtype_id, name, value)
Signature:
herr_t H5Tenum_insert( hid_t dtype_id, const char *name, void *value )
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
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 |
Description:
H5T_ENUM_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 H5T_CONVERT on values as they are read from or written to a dataset.
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Example:
--- Last Modified: May 10, 2019 | 02:45 PM
