Page tree

 

JAVA

FORTRAN

C++

C

 

Link

H5D_GET_SPACE_STATUS

Determines whether space has been allocated for a dataset

Procedure:

H5D_GET_SPACE_STATUS(dset_id, status)

Signature:

herr_t H5Dget_space_status(hid_t dset_id, H5D_space_status_t *status)

SUBROUTINE h5dget_space_status_f(dset_id, flag, hdferr)
  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN) :: dset_id  ! Dataset identifier 
  INTEGER, INTENET(OUT)      :: flag     ! Status flag ; possible values:
                                         ! H5D_SPACE_STS_ERROR_F
                                         ! H5D_SPACE_STS_NOT_ALLOCATED_F
                                         ! H5D_SPACE_STS_PART_ALLOCATED_F
                                         ! H5D_SPACE_STS_ALLOCATED_F
  INTEGER, INTENT(OUT) :: hdferr         ! Error code  
                                         ! 0 on success and -1 on failure
END SUBROUTINE h5dget_space_status_f

Parameters:
hid_t dset_idIN: Identifier of the dataset to query
H5D_space_status_t *status    OUT: Space allocation status

Description:

H5D_GET_SPACE_STATUS determines whether space has been allocated for the dataset dset_id.

Space allocation status is returned in status, which will have one of the following values:

H5D_SPACE_STATUS_NOT_ALLOCATEDSpace has not been allocated for this dataset.
H5D_SPACE_STATUS_ALLOCATEDSpace has been allocated for this dataset.
H5D_SPACE_STATUS_PART_ALLOCATED  Space has been partially allocated for this dataset. (Used only for datasets with chunked storage.)

Returns:

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

Example:

Coming Soon!

History:
Release    C
1.6.0Function introduced in this release.

--- Last Modified: April 13, 2018 | 09:32 AM