Creates an exact copy of a dataspace

Procedure:

H5S_COPY ( space_id )

Signature:

<pre><code class="language-c">hid_t H5Scopy(
        hid_t space_id
    )

</code></pre>

<pre><code class="language-fortran">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
    

</code></pre>

Parameters:

hid_t space_id     IN: Identifier of dataspace to copy

Description:

H5S_COPY 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 H5S_CLOSE or resource leaks will occur.

Returns:

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

Example:

Coming Soon!

History:

None