Last modified: 27 April 2010
Name: H5Aopen_name
Signature:
  hid_t `H5Aopen_name`( hid_t `loc_id`, const char *`name` )

Purpose:
  Opens an attribute specified by name.

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

Description:
  `H5Aopen_name` opens an attribute specified by its name, `name`, which is attached to the object specified with `loc_id`. The location object may be either a group, dataset, or named datatype, which may have any sort of attribute. 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 a group, dataset, or named datatype that attribute is attached to.
  const char *`name` | IN: Attribute name.

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

Fortran90 Interface: h5aopen_name_f

      SUBROUTINE h5aopen_name_f(obj_id, name, attr_id, hdferr)
        IMPLICIT NONE
        INTEGER(HID_T), INTENT(IN) :: obj_id    ! Object identifier
        CHARACTER(LEN=*), INTENT(IN) :: name    ! Attribute name
        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_name_f