Iterates through links in a group by its name
Signature:
herr_t H5Literate_by_name2(hid_t loc_id, const char *group_name,
H5_index_t idx_type, H5_iter_order_t order, hsize_t *idx_p,
H5L_iterate2_t op, void *op_data, hid_t lapl_id)
herr_t H5Literate_by_name1(hid_t loc_id, const char *group_name,
H5_index_t idx_type, H5_iter_order_t order, hsize_t *idx_p,
H5L_iterate1_t op, void *op_data, hid_t lapl_id)
Description:
H5L_ITERATE_BY_NAME is a macro that is mapped to either of:
Such macros are provided to facilitate application compatibility. Their use and mappings are fully described in API Compatibility Macros in HDF5.
If the library and/or application is compiled for Release 1.12 emulation, H5L_ITERATE_BY_NAME will be mapped to H5L_ITERATE_BY_NAME2 and H5L_ITERATE_BY_NAME1 is deprecated. With earlier versions, H5L_ITERATE_BY_NAME is mapped to H5L_ITERATE_BY_NAME1.
Specific compile-time compatibility flags and the resulting mappings are as follows:
No compatibility flag | H5L_ITERATE_BY_NAME2 (using 1.12 source) H5L_ITERATE_BY_NAME1 (using 1.10 or 1.8 source) |
| Emulate Release 1.12 | H5L_ITERATE_BY_NAME2 |
Emulate Release 1.8 or 1.10 interface | H5L_ITERATE_BY_NAME1 |
History:
| Release | Change |
|---|
| 1.12.0 | The function H5L_ITERATE_BY_NAME was renamed to H5L_ITERATE_BY_NAME1 and deprecated in this release.The macro H5L_ITERATE_BY_NAME and the function H5L_ITERATE_BY_NAME2 were introduced in this release. |
--- Last Modified: March 08, 2021 | 01:32 PM
