Last modified: 9 October 2014

Signature:

hid_t H5Dget_space( hid_t dataset_id )

Purpose:

Returns an identifier for a copy of the dataspace for a dataset.

Description:

H5Dget_space makes a copy of the dataspace of the dataset specified by dataset_id. The function returns an identifier for the new copy of the dataspace.

A dataspace identifier returned from this function should be released with H5Sclose when the identifier is no longer needed so that resource leaks will not occur.

Parameters:

hid_t dataset_id IN: Identifier of the dataset to query.

Returns:

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

Fortran90 Interface: h5dget_space_f

SUBROUTINE h5dget_space_f(dataset_id, dataspace_id, hdferr) 
  IMPLICIT NONE 
  INTEGER(HID_T), INTENT(IN) :: dataset_id      ! Dataset identifier
  INTEGER(HID_T), INTENT(OUT) :: dataspace_id   ! Dataspace identifier
  INTEGER, INTENT(OUT) :: hdferr                ! Error code 
                                                ! 0 on success and -1 on failure
END SUBROUTINE h5dget_space_f

See Also:

“Using Identifiers”