Last modified: 14 October 2014
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 committed (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:

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

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

Fortran90 Interface: h5oopen_f
See Also:
  “Using Identifiers”
History:

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