Retrieves library version bounds settings that indirectly control the format versions used when creating objects
Procedure:
H5P_GET_LIBVER_BOUNDS ( fapl_id, low, high )
Signature:
herr_t H5Pget_libver_bounds(
hid_t fapl_id,
H5F_libver_t *low,
H5F_libver_t *high
)
Parameters:
hid_t fapl_id | IN: File access property list identifier |
H5F_libver_t *low | OUT: The earliest version of the library that will be used for writing objects |
H5F_libver_t *high | OUT: The latest version of the library that will be used for writing objects |
Description:
H5P_GET_LIBVER_BOUNDS retrieves the lower and upper bounds on the HDF5 library release versions that indirectly determine the object format versions used when creating objects in the file.
This property is retrieved from the file access property list specified by the parameter fapl_id.
The value returned in the parameters low and high is one of the enumerated values in the H5F_libver_t struct, which is defined in H5Fpublic.h:
typedef enum H5F_libver_t {
H5F_LIBVER_EARLIEST,
H5F_LIBVER_V18 = 1,
H5F_LIBVER_V110 = 2,
H5F_LIBVER_NBOUNDS
} H5F_libvert_t;
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Example:
/* Create a file with default fapl setting */
fid = H5Fcreate(FILE8, H5F_ACC_TRUNC, H5P_DEFAULT, H5P_DEFAULT);
/* Get the file’s file access property list */
fid_fapl = H5Fget_access_plist(fid);
/* Retrieve the low/high bounds from the file’s fapl */
ret = H5Pget_libver_bounds(fid_fapl, &low, &high);
/* The low and high values retrieved will be H5F_LIBVER_EARLIEST and H5F_LIBVER_LATEST respectively */
:
:
:
History:
| Release | Changes |
|---|
| 1.10.2 | Add H5F_LIBVER_V18 to the enumerated defines in H5F_libver_t |
| 1.8.0 | Function introduced in this release. |
--- Last Modified: August 06, 2019 | 12:23 PM
