H5Pset_file_space
(
hid_t fcpl_id
,
H5F_file_space_type_t strategy
,
hsize_t threshold
)
H5Pset_file_space
provides the means for applications to manage the HDF5 file's file
space for their specific needs.
H5Pset_file_space
sets the file space management strategy for the file associated with
fcpl_id
to strategy
.
There are four strategies that applications can select and
they are described in the Parameters section.
This routine can also set the free-space section threshold to
threshold
so that the library’s free-space managers
will track only free-space sections whose size is greater than or equal
to the value of threshold
for the file.
Passing a zero value for strategy
or thresold
indicates the corresponding parameter's value should not be modified
as a result of the call.
Note: The file space management strategy and/or free-space section threshold set via this routine cannot be changed once the file is created.
hid_t fcpl_id
|
||||||||||||||||||||
|
IN: The file creation property list identifier. | |||||||||||||||||||
H5F_file_space_type_t strategy
|
||||||||||||||||||||
IN: The strategy for file space management.
Valid values are as follows:
| ||||||||||||||||||||
hsize_t threshold
|
||||||||||||||||||||
IN: The free-space section threshold.
The library default is 1, which is to track all free-space sections.
Passing a value of zero ( |
fcpl
to
H5F_FILE_SPACE_ALL_PERSIST
.
It also sets the free-space section threshold to 10
,
which means that the library's free-space managers will track
only free-space sections whose size is >= 10 for the file.
H5Pset_file_space(fcpl, H5F_FILE_SPACE_ALL_PERSIST, (hsize_t)10);
fcpl
to
H5F_FILE_SPACE_VFD
.
It does not change the free-space section threshold in use for
the file.
H5Pset_file_space(fcpl, H5F_FILE_SPACE_VFD, (hsize_t)0);
H5Pget_file_space
Release | Change |
1.10.0 | C function introduced in this release. |