Copies an existing datatype
Procedure:
Signature:
hid_t H5Tcopy( hid_t dtype_id )
SUBROUTINE h5tcopy_f(type_id, new_type_id, hdferr)
IMPLICIT NONE
INTEGER(HID_T), INTENT(IN) :: type_id ! Datatype identifier
INTEGER(HID_T), INTENT(OUT) :: new_type_id ! Identifier of datatype's copy
INTEGER, INTENT(OUT) :: hdferr ! Error code
! 0 on success and -1 on failure
END SUBROUTINE h5tcopy_f
Parameters:
hid_t dtype_id | IN: Identifier of datatype to copy. Can be a datatype identifier, a predefined datatype (defined inH5Tpublic.h), or a dataset identifier |
Description:
H5T_COPY copies an existing datatype. The returned type is always transient and unlocked.
The dtype_id argument can be either a datatype identifier, a predefined datatype (defined in H5Tpublic.h), or a dataset identifier. If dtype_id is a dataset identifier instead of a datatype identifier, then this function returns a transient, modifiable datatype which is a copy of the dataset's datatype.
The datatype identifier returned should be released with H5T_CLOSE or resource leaks will occur.
Returns:
Returns a datatype identifier if successful; otherwise returns a negative value
Example:
--- Last Modified: May 10, 2019 | 02:28 PM
