Renames an object within an HDF5 file
Procedure:
H5G_MOVE2(src_loc_id, src_name, dst_loc_id, dst_name)
Signature:
herr_t H5Gmove2( hid_t src_loc_id, const char *src_name, hid_t dst_loc_id, const char *dst_name )
SUBROUTINE h5gmove2_f(src_loc_id, src_name, dst_loc_id, dst_name, hdferr)
IMPLICIT NONE
INTEGER(HID_T), INTENT(IN) :: src_loc_id ! File or group identifier
CHARACTER(LEN=*), INTENT(IN) :: src_name ! Original name of an object
! relative to src_loc_id
INTEGER(HID_T), INTENT(IN) :: dst_loc_id ! File or group identifier
CHARACTER(LEN=*), INTENT(IN) :: dst_name ! New name of an object
! relative to dst_loc_id
INTEGER, INTENT(OUT) :: hdferr ! Error code
! 0 on success and -1 on failure
END SUBROUTINE h5gmove2_f
Parameters:
hid_t src_loc_id | IN: Original file or group identifier |
const char *src_name | IN: Object's original name |
hid_t dst_loc_id | IN: Destination file or group identifier |
const char *dst_name | IN: Object's new name |
Description:
H5G_MOVE2 renames an object within an HDF5 file. The original name, src_name
, is unlinked from the group graph and the new name, dst_name
, is inserted as an atomic operation.
src_name
and dst_name
are interpreted relative to src_name
and dst_name
, respectively, which are either file or group identifiers.
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Example:
History:
Release | Change |
---|
1.8.0 | Function deprecated in this release. |
--- Last Modified: April 25, 2019 | 11:45 AM