/**
* \ingroup H5O
* \def H5Ovisit_by_name()
*
* #H5Ovisit_by_name is a macro that is mapped to one of the following:
* \li H5Ovisit_by_name3()
* \li H5Ovisit_by_name1()
*
* \details 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.
*
* In HDF5 versions 1.12 and after, \ref H5Ovisit_by_name() is mapped to
* \ref H5Ovisit_by_name3(). In version 1.10, \ref H5Ovisit_by_name()
* is identical to \ref H5Ovisit_by_name1().
*
* Specific compile-time compatibility flags and the resulting
* mappings are as follows:
*
* \par
*
*
* Compatibility settings |
* H5Ovisit_by_name |
*
*
* No compatibility flag |
* \ref H5Ovisit_by_name3() for 1.12 and above |
*
*
|
* \ref H5Ovisit_by_name1() for 1.10 or 1.8 |
*
*
* Emulate Release 1.12 interface |
* \ref H5Ovisit_by_name3() |
*
*
* Emulate Release 1.10 or 1.8 interface |
* \ref H5Ovisit_by_name1() |
*
*
*
* \todo Fix reference to the document
*
* \par Version
*
*
* Release |
* Change |
*
*
* 1.12.0 |
* The macro #H5Ovisit_by_name and function \ref H5Ovisit_by_name3() were added.
* |
*
* 1.10.5 |
* The macro #H5Ovisit_by_name was removed. |
*
*
* |
* The functions \ref H5Ovisit_by_name() and
* H5Ovisit_by_name1() 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 \ref H5Ovisit_by_name() was renamed
* to \ref H5Ovisit_by_name1. |
*
*
* |
* The macro #H5Ovisit_by_name and the function \ref H5Ovisit_by_name2()
* were introduced in this release. |
*
*
* 1.8.8 |
* Fortran subroutine introduced in this release. |
*
*
* 1.8.0 |
* Function introduced in this release. |
*
*
*
*
*/