Page tree

 

JAVA

FORTRAN

C++

C

 

Link

H5G_MOVE2

Renames an object within an HDF5 file

This function is deprecated in favor of the function H5L_MOVE.

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_idIN: Original file or group identifier
const char *src_name    IN: Object's original name
hid_t dst_loc_idIN: Destination file or group identifier
const char *dst_nameIN: 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.

Exercise care in moving groups as it is possible to render data in a file inaccessible with H5G_MOVE2. See The Group Interface in the HDF5 User's Guide.


Returns:

Returns a non-negative value if successful; otherwise returns a negative value.

Example:

Coming soon!

 

History:
Release    Change
1.8.0Function deprecated in this release.

--- Last Modified: April 25, 2019 | 11:45 AM