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 |
Release | C |
1.8.1 | Fortran subroutine introduced in this release. |
1.8.0 | Function introduced in this release. |