Name: H5Pset_link_phase_change
Signature:
herr_t H5Pset_link_phase_change( hid_t gcpl_id, unsigned max_compact, unsigned min_dense )

Purpose:
Sets the parameters for conversion between compact and dense groups.

Description:
H5Pset_link_phase_change sets the maximum number of entries for a compact group and the minimum number of links to allow before converting a dense group to back to the compact format.

max_compact is the maximum number of links to store as header messages in the group header as before converting the group to the dense format. Groups that are in compact format and in which the exceed this number of links rises above this threshold are automatically converted to dense format.

min_dense is the minimum number of links to store in the dense format. Groups which are in dense format and in which the number of links falls below this theshold are automatically converted to compact format.

See “Group implementations in HDF5” in the H5G API introduction for a discussion of the available types of HDF5 group structures.

Parameters:
hid_t gcpl_id IN: Group creation property list identifier
unsigned max_compact     IN: Maximum number of links for compact storage
(Default: 8)
unsigned min_dense IN: Minimum number of links for dense storage
(Default: 6)

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

Fortran90 Interface: h5pset_link_phase_change_f
SUBROUTINE h5pset_link_phase_change_f(gcpl_id, max_compact, min_dense, hdferr)
  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN) :: gcpl_id ! Group creation property list id
  INTEGER, INTENT(IN) :: max_compact    ! Maximum number of attributes to be 
                                        ! stored in compact storage
  INTEGER, INTENT(IN) :: min_dense      ! Minimum number of attributes to be 
                                        ! stored in dense storage
  INTEGER, INTENT(OUT) :: hdferr        ! Error code 
                                        ! 0 on success and -1 on failure
END SUBROUTINE h5pset_link_phase_change_f
    

History:
Release     C
1.8.0 Function introduced in this release.