Last modified: 17 August 2010
Name: H5Scopy
Signature:
  hid_t `H5Scopy`( hid_t `space_id` )

Purpose:
  Creates an exact copy of a dataspace.

Description:
  `H5Scopy` creates a new dataspace which is an exact copy of the dataspace identified by `space_id`. The dataspace identifier returned from this function should be released with `H5Sclose` or resource leaks will occur.

Parameters:

  hid_t `space_id` | IN: Identifier of dataspace to copy.

Returns:
  Returns a dataspace identifier if successful; otherwise returns a negative value.

Fortran90 Interface: h5scopy_f

      SUBROUTINE h5scopy_f(space_id, new_space_id, hdferr)
        IMPLICIT NONE
        INTEGER(HID_T), INTENT(IN) :: space_id      ! Dataspace identifier
        INTEGER(HID_T), INTENT(OUT) :: new_space_id ! Identifier of dataspace copy
        INTEGER, INTENT(OUT) :: hdferr              ! Error code
                                                    ! 0 on success and -1 on failure
      END SUBROUTINE h5scopy_f