Page tree

 

JAVA

FORTRAN

C++

C

 

Link

H5P_GET_FILE_SPACE_STRATEGY

Retrieves the file space handling strategy, persisting free-space condition and threshold value for a file creation property list

Procedure:

H5P_GET_FILE_SPACE_STRATEGY ( fcpl, strategy, persist, threshold )

Signature:

herr_t H5Pget_file_space_strategy(
        hid_t fcpl, 
        H5F_fspace_strategy_t *strategy, 
        hbool_t *persist, 
        hsize_t *threshold )    
    

Parameters:
hid_t fcplIN: The file creation property list identifier
H5F_fspace_strategy_t *strategyOUT: The file space handling strategy
hbool_t *persistOUT: The boolean value indicating whether free space is persistent or not
hsize_t *thresholdOUT: The free-space section size threshold value

Description:

H5P_GET_FILE_SPACE_STRATEGY retrieves the file space handling strategy, the persisting free-space condition and the threshold value in the parameters strategy, persist and threshold respectively.

The library default values returned when H5P_SET_FILE_SPACE_STRATEGY has not been called are:

  • strategyH5F_FSPACE_STRATEGY_FSM_AGGR
  • persist ‐  0
  • threshold - 1

Returns:

Returns a non-negative value if successful; otherwise returns a negative value.

Example:

History:
Release    Change
1.10.1C function introduced with this release.

--- Last Modified: July 22, 2020 | 09:10 AM