Last modified: 10 April 2013
Name: H5Oopen
Signature:
hid_t H5Oopen( hid_t loc_id, const char *name, hid_t lapl_id )

Purpose:
Opens an object in an HDF5 file by location identifier and path name.

Description:
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.

Parameters:

Returns:
Returns an object identifier for the opened object if successful; otherwise returns a negative value.

Fortran90 Interface: h5oopen_f

History:
Release     C
1.8.1 Fortran subroutine introduced in this release.
1.8.0 Function introduced in this release.