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. |