Last modified: 27 April 2010
Name: H5Aopen_idx
Signature:
hid_t H5Aopen_idx( hid_t loc_id, unsigned int idx )

Purpose:
Opens the attribute specified by its index.

Deprecated Function:
This function is deprecated in favor of the function H5Aopen_by_idx.

Description:
H5Aopen_idx opens an attribute which is attached to the object specified with loc_id. The location object may be either a group, dataset, or named datatype, all of which may have any sort of attribute. The attribute specified by the index, idx, indicates the attribute to access. The value of idx is a 0-based, non-negative integer. The attribute identifier returned from this function must be released with H5Aclose or resource leaks will develop.

Parameters:
hid_t loc_id IN: Identifier of the group, dataset, or named datatype attribute to be attached to.
unsigned int idx     IN: Index of the attribute to open.

Returns:
Returns attribute identifier if successful; otherwise returns a negative value.

Fortran90 Interface: h5aopen_idx_f
SUBROUTINE h5aopen_idx_f(obj_id, index, attr_id, hdferr) 
  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN) :: obj_id    ! Object identifier 
  INTEGER, INTENT(IN) :: index            ! Attribute index 
  INTEGER(HID_T), INTENT(OUT) :: attr_id  ! Attribute identifier 
  INTEGER, INTENT(OUT) :: hdferr          ! Error code:
                                          ! 0 on success and -1 on failure
END SUBROUTINE h5aopen_idx_f