Procedure:
H5_VERSION_LE(maj, min, rel)
Signature:
H5_VERSION_LE
(
int maj,
int min,
int rel
)
Parameters:
int maj | IN: Major version number
A non-negative integer value |
int min | IN: Minor version number
A non-negative integer value |
int rel | IN: Release number
A non-negative integer value |
Description:
The H5_VERSION_GE and H5_VERSION_LE macros are used at compile time to conditionally include or exclude code based on the version of the HDF5 library against which an application will be linked.
The H5_VERSION_LE macro compares the version of the HDF5 library being used against the version number specified in the parameters.
For more information about release versioning, see HDF5 Library Release Version Numbers.
Returns:
A value of 1 is returned if the library version is less than or equal to the version number specified.
A value of 0 is returned if the library version is greater than the version number specified.
A library version is less than the specified version number if its major version is smaller than the specified major version number. If the major version numbers are the same, it is less than the specified version number if its minor version is smaller than the specified minor version number. If the minor version numbers are the same, then a library version would be less than the specified version number if its release number is smaller than the specified release number.
Example:
Suppose an application wants to call different functions based on the version of the HDF5 library to which an application will be linked. For example, the link functions,
H5Lxxx, are new in the 1.8 versions of HDF5, and some group functions,
H5Gxxx, are deprecated in the 1.8 versions. The following code uses
H5Gunlink if the library version is 1.6.10 or earlier or uses
H5Ldelete if the library version is not 1.6.10 or earlier. Similarly, the code calls
H5Gopen or
H5Lexists to make sure the group has been deleted.
#if H5_VERSION_LE(1,6,10)
ret = H5Gunlink(file, "Group");
CHECK(ret, FAIL, "H5Gunlink");
H5E_BEGIN_TRY {
grp = H5Gopen(file, "Group");
} H5E_END_TRY;
VERIFY(grp, FAIL, "H5Gopen");
#else
ret = H5Ldelete(file, "Group", H5P_DEFAULT);
CHECK(ret, FAIL, "H5Lunlink");
status = H5Lexists(file, "Group", H5P_DEFAULT);
VERIFY(status, FALSE, "H5Lexists");
#endif
History:
Release | Change |
|---|
| 1.8.7 | C macro introduced in this release. |
