Adds a new member to a compound datatype
Procedure:
H5T_INSERT (dtype_id, name, offset, field_id)
Signature:
herr_t H5Tinsert( hid_t dtype_id, const char * name, size_t offset, hid_t field_id )
SUBROUTINE h5tinsert_f(type_id, name, offset, field_id, hdferr)
IMPLICIT NONE
INTEGER(HID_T), INTENT(IN) :: type_id ! Datatype identifier
CHARACTER(LEN=*), INTENT(IN) :: name ! Name of the field to insert
INTEGER(SIZE_T), INTENT(IN) :: offset ! Offset in memory structure
! of the field to insert
INTEGER(HID_T), INTENT(IN) :: field_id ! Datatype identifier of the
! new member
INTEGER, INTENT(OUT) :: hdferr ! Error code
END SUBROUTINE h5tinsert_f
Parameters:
hid_t dtype_id | IN: Identifier of compound datatype to modify |
const char * name | IN: Name of the field to insert |
size_t offset | IN: Offset in memory structure of the field to insert |
hid_t field_id | IN: Datatype identifier of the field to insert |
Description:
H5T_INSERT adds another member to the compound datatype dtype_id. The new member has a name which must be unique within the compound datatype. The offset argument defines the start of the member in an instance of the compound datatype, and field_id is the datatype identifier of the new member.
Note: Members of a compound datatype do not have to be atomic datatypes; a compound datatype can have a member which is a compound datatype.
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Example:
--- Last Modified: May 17, 2019 | 03:25 PM
