Name: H5Ocopy
Signature:
herr_t H5Ocopy( hid_t src_loc_id, const char *src_name, hid_t dst_loc_id, const char *dst_name, hid_t ocpypl_id, hid_t lcpl_id )
Purpose:
Copies an object in an HDF5 file.
Description:
H5Ocopy copies the group, dataset or named datatype specified by src_name from the file or group specified by src_loc_id to the destination location dst_loc_id.

The destination location, as specified in dst_loc_id, may be a group in the current file or a location in a different file. If dst_loc_id is a file identifier, the copy will be placed in that file’s root group.

The new copy will be created with the name dst_name. dst_name must not pre-exist in the destination location; if dst_name already exists at the location dst_loc_id, H5Ocopy will fail.

The new copy of the object is created with the creation property lists specified by ocpypl_id and lcpl_id.

Several flags are available to govern the behavior of H5Ocopy. These flags are set in the creation property list cplist_id with H5Pset_copy_object and H5Pset_create_intermediate_group. All of the available flags are described at H5Pset_copy_object.

Parameters:

Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Fortran90 Interface:
None.
History: