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.