H5Aexists_by_name(
hid_t loc_id,
const char *obj_name,
const char *attr_name,
hid_t lapl_id
)
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.
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 |
TRUE,
or 0 (zero), for FALSE.
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
| Release | C |
| 1.8.0 | Function introduced in this release. |