Recursively visits all objects accessible from a specified object
Signature:
herr_t H5Ovisit( hid_t object_id, H5_index_t index_type, H5_iter_order_t order, H5O_iterate_t op, void *op_data )
herr_t H5Ovisit( hid_t object_id, H5_index_t index_type, H5_iter_order_t order, H5O_iterate_t op, void *op_data, unsigned int fields )
SUBROUTINE h5ovisit_f(object_id, index_type, order, op, op_data, &
return_value, hdferr)
INTEGER(HID_T), INTENT(IN) :: object_id
INTEGER, INTENT(IN) :: index_type
INTEGER, INTENT(IN) :: order
TYPE(C_FUNPTR):: op
TYPE(C_PTR) :: op_data
INTEGER, INTENT(OUT) :: return_value
INTEGER, INTENT(OUT) :: hdferr
Description:
H5O_VISIT is a macro that is mapped to either H5O_VISIT1 or H5O_VISIT2.
In HDF5-1.10, H5O_VISIT is identical to H5O_VISIT1.
In the next major release (HDF5-1.12), H5O_VISIT is a macro that is mapped to either H5O_VISIT1 or H5O_VISIT2.
Such macros are provided to facilitate application compatibility. Their use and mappings are fully described in API Compatibility Macros in HDF5; we urge you to read that document closely.
If the library and/or application is compiled for Release 1.8 or 1.10 emulation, H5O_VISIT will be mapped to H5O_VISIT1. With later versions, H5O_VISIT is mapped to H5O_VISIT2 (and H5O_VISIT1 is deprecated).
Specific compile-time compatibility flags and the resulting mappings are as follows:
| Compatibility settings | H5Ovisit |
|---|
| No compatibility flag | H5Ovisit1 for 1.8 or 1.10
H5Ovisit2 for > 1.10
|
Emulate Release 1.8 interface | H5Ovisit1 |
| Emulate Release 1.10 interface | H5Ovisit1 |
| Emulate Releases after 1.10 | H5Ovisit2 |
Example:
History:
| Release | Change |
|---|
| 1.12.0 | The function H5Ovisit was replaced by the macro H5Ovisit. |
| 1.10.5 | The macro H5Ovisit was removed. The functions H5Ovisit and H5Ovisit1 are identical in this release. This change was added to restore the broken API compatibility introduced in HDF5-1.10.3.
|
| 1.10.3 | The function H5Ovisit was renamed to H5Ovisit1. The macro H5Ovisit and the function H5Ovisit2 were introduced in this release. |
| 1.8.8 | Fortran subroutine and data structure added. |
| 1.8.0 | C function introduced. |
--- Last Modified: September 05, 2019 | 12:57 PM
