Opens an existing dataset
Procedure:
H5D_OPEN2(loc_id, name, dapl_id)
Signature:
hid_t H5Dopen2( hid_t loc_id, const char *name, hid_t dapl_id )
SUBROUTINE h5dopen_f(loc_id, name, dset_id, hdferr, dapl_id)
IMPLICIT NONE
INTEGER(HID_T), INTENT(IN) :: loc_id ! File or group identifier
CHARACTER(LEN=*), INTENT(IN) :: name ! Name of the dataset
INTEGER(HID_T), INTENT(OUT) :: dset_id ! Dataset identifier
INTEGER, INTENT(OUT) :: hdferr ! Error code:
! 0 on success and -1 on failure
INTEGER(HID_T), OPTIONAL, INTENT(IN) :: dapl_id
! Dataset access property list
END SUBROUTINE h5dopen_f
Parameters:
hid_t loc_id | IN: Location identifier; may be a file, group, named datatype, dataset, or attribute |
const char *name | IN: Dataset name |
hid_t dapl_id | IN: Dataset access property list |
Description:
H5D_OPEN2 opens the existing dataset specified by a location identifier and name, loc_id and name, respectively. loc_id may be a file, group, dataset, named datatype or attribute. If an attribute, dataset, or named datatype is specified for loc_id then the dataset will be opened at the location where the attribute, dataset, or named datatype is attached.
The dataset access property list, dapl_id, provides information regarding access to the dataset.
To conserve and release resources, the dataset should be closed when access is no longer required.
Returns:
Returns a dataset identifier if successful; otherwise returns a negative value.
Example:
History:
| Release | Change |
|---|
| 1.8.0 | Function introduced in this release. |
--- Last Modified: August 01, 2019 | 12:32 PM
