H5Aiterate1(
hid_t loc_id,
unsigned * idx,
H5A_operator1_t op,
void *op_data
)
H5Aiterate2.
H5Aiterate1 iterates over the attributes of
the object specified by its identifier, loc_id.
The object can be a group, dataset, or named datatype.
For each attribute of the object, the op_data
and some additional information specified below are passed
to the operator function op.
The iteration begins with the attribute specified by its
index, idx; the index for the next attribute
to be processed by the operator, op, is
returned in idx.
If idx is the null pointer, then all attributes
are processed.
The prototype for H5A_operator_t is:
typedef herr_t (*H5A_operator1_t)(hid_t loc_id,
const char *attr_name,
void *operator_data);
The operation receives the identifier for the group, dataset
or named datatype being iterated over, loc_id, the
name of the current attribute about the object, attr_name,
and the pointer to the operator data passed in to H5Aiterate1,
op_data. The return values from an operator are:
hid_t loc_id |
IN: Identifier of a group, dataset or named datatype. |
unsigned * idx |
IN/OUT: Starting (IN) and ending (OUT) attribute index. |
H5A_operator1_t op |
IN: User's function to pass each attribute to |
void *op_data |
IN/OUT: User's data to pass through to iterator operator function |
| Release | C |
| 1.8.0 |
The function H5Aiterate renamed to
H5Aiterate1 and deprecated in this release. |