Name: H5Aexists_by_name
Signature:
  htri_t `H5Aexists_by_name`( hid_t `loc_id`, const char *`obj_name`, const char *`attr_name`, hid_t `lapl_id` )

Purpose:
  Determines whether an attribute with a given name exists on an object.

Description:
  `H5Aexists_by_name` determines whether the attribute `attr_name` exists on an object. That object is specified by its location and name, `loc_id` and `obj_name`, respectively.

  `loc_id` specifies a location in the file containing the object. `obj_name` is the name of the object to which the attribute is attached and can be a relative name, relative to `loc_id`, or an absolute name, based in the root group of the file. If `loc_id` fully specifies the object, `obj_name` should be `'.'` (a dot).

  The link access property list, `lapl_id`, may provide information regarding the properties of links required to access `obj_name`. See “Link Access Properties” in the H5P APIs.

Parameters:

  hid_t `loc_id`, | IN: Location identifier
  const char *`obj_name` | IN: Object name Either relative to `loc_id`, absolute from the file’s root group, or `'.'` (a dot)
  const char *`attr_name` | IN: Attribute name
  hid_t `lapl_id` | IN: Link access property list identifier

Returns:
  When successful, returns a positive value, for `TRUE`, or `0` (zero), for `FALSE`.
  Otherwise returns a negative value.

Fortran90 Interface: h5aexists_by_name_f

      SUBROUTINE h5aexists_by_name_f(loc_id, obj_name, attr_name, attr_exists, hdferr,&
           lapl_id)
        IMPLICIT NONE
        INTEGER(HID_T), INTENT(IN) :: loc_id  ! Location identifier
        CHARACTER(LEN=*), INTENT(IN) :: obj_name
                                              ! Object name either relative to loc_id,
                                              ! absolute from the
                                              ! file’s root group, or '.'
        CHARACTER(LEN=*), INTENT(IN) :: attr_name
                                              ! Attribute name
        LOGICAL, INTENT(OUT) :: attr_exists   ! .TRUE. if exists, .FALSE. otherwise
        INTEGER, INTENT(OUT) :: hdferr        ! Error code:
                                              ! 0 on success and -1 on failure
        INTEGER(HID_T), OPTIONAL, INTENT(IN) :: lapl_id
                                              ! Link access property list identifier
      END SUBROUTINE h5aexists_by_name_f

History:

  Release | C
  1.8.0 | Function introduced in this release.