Name: H5Oopen_by_idx
Signature:
hid_t H5Oopen_by_idx( hid_t loc_id, const char *group_name, H5_index_t index_type, H5_iter_order_t order, hsize_t n, hid_t lapl_id )

Purpose:
Open the nth object in a group.

Description:
H5Oopen_by_idx opens the nth object in the group specified by loc_id and group_name.

loc_id specifies a file or group. group_name specifies the group relative to loc_id in which the object can be found. If loc_id fully specifies the group in which the object resides, group_name can be a dot (.).

The specific object to be opened within the group is specified by index_type, order, and n as follows:

If lapl_id specifies the link access property list to be used in accessing the object.

Parameters:
hid_t loc_id IN: A file or group identifier.
const char *group_name     IN: Name of group, relative to loc_id, in which object is located
H5_index_t index_type IN: Type of index by which objects are ordered
H5_iter_order_t order IN: Order of iteration within index
hsize_t n IN: Object to open
hid_t lapl_id IN: Link access property list

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

Fortran90 Interface:
None.

History:
Release     C
1.8.0 Function introduced in this release.