H5Oopen
(
hid_t loc_id
,
const char *name
,
hid_t lapl_id
)
H5Oopen
opens a group, dataset, or named datatype
specified by a location, loc_id
, and a path name,
name
, in an HDF5 file.
This function opens the object in the same manner as
H5Gopen
, H5Topen
, and H5Dopen
.
However, H5Oopen
does not require the type of object
to be known beforehand. This can be useful with user-defined links,
for instance, when only a path may be known.
H5Oopen
cannot be used to open a
dataspace, attribute, property list, or file.
Once an object of unknown type has been opened with
H5Oopen
, the type of that object can be determined
by means of an
H5Iget_type
call.
loc_id
can be either a file or group identifier.
name
must be the path to that object relative to
loc_id
.
lapl_id
is the link access property list associated
with the link pointing to the object. If default link access
properties are appropriate, this can be passed in as
H5P_DEFAULT
.
When it is no longer needed, the opened object should be closed
with H5Oclose
, H5Gclose
,
H5Tclose
, or H5Dclose
.
hid_t loc_id
|
IN: File or group identifier |
const char *name
|
IN: Path to the object,
relative to loc_id .
|
hid_t lapl_id
|
IN: Access property list identifier for the link pointing to the object |
SUBROUTINE h5oopen_f(loc_id, name, obj_id, hdferr, lapl_id) IMPLICIT NONE INTEGER(HID_T), INTENT(IN) :: loc_id ! File or group identifier CHARACTER(LEN=*), INTENT(IN) :: name ! Path to the object, ! relative to loc_id INTEGER(HID_T), INTENT(OUT) :: obj_id ! Object identifier for opened object INTEGER, INTENT(OUT) :: hdferr ! Error code ! Success: 0 ! Failure: -1 INTEGER(HID_T), OPTIONAL, INTENT(IN) :: lapl_id ! Attribute access property list END SUBROUTINE h5oopen_f
Release | C |
1.8.0 | Function introduced in this release. |