Opens an existing dataset
Procedure:
Signature:
hid_t H5Dopen1( hid_t loc_id, const char *name )
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, dataset, named datatype, or attribute |
const char * name | IN: The name of the dataset to access |
Description:
H5D_OPEN1 opens an existing dataset for access at the location specified by loc_id. 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. name is a dataset name and is used to identify the dataset in the file.
A dataset opened with this function should be closed with H5D_CLOSE when the dataset is no longer needed so that resource leaks will not develop.
Returns:
Returns a dataset identifier if successful; otherwise returns a negative value.
Example:
History:
| Release | Change |
|---|
| 1.8.0 | Function H5Dopen renamed to H5Dopen1 and deprecated in this release. |
| 1.4.0 | Fortran call introduced in this release. |
| 1.0.0 | C function introduced in this release. |
--- Last Modified: July 29, 2020 | 01:39 PM
