Page tree

The license could not be verified: License Certificate has expired!

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

 

JAVA

FORTRAN

C++

C

 

Link

H5P_SET_LOCAL_HEAP_SIZE_HINT

Specifies the anticipated maximum size of a local heap

Procedure:

H5P_SET_LOCAL_HEAP_SIZE_HINT ( gcpl_id, size_hint )

Signature:

herr_t H5Pset_local_heap_size_hint(
        hid_t gcpl_id,
        size_t size_hint
    )
  

Parameters:
hid_t gcpl_idIN: Group creation property list identifier
size_t size_hint    IN: Anticipated maximum size in bytes of local heap

Description:

H5Pset_local_heap_size_hint is used with original-style HDF5 groups (see “Motivation” below) to specify the anticipated maximum local heap size, size_hint, for groups created with the group creation property list gcpl_id. The HDF5 Library then uses size_hint to allocate contiguous local heap space in the file for each group created with gcpl_id.

For groups with many members or very few members, an appropriate initial value of size_hint would be the anticipated number of group members times the average length of group member names, plus a small margin:

          size_hint = max_number_of_group_members  * 
                      (average_length_of_group_member_link_names + 2)
      

If it is known that there will be groups with zero members, the use of a group creation property list with size_hint set to to 1 (one) will guarantee the smallest possible local heap for each of those groups.

Setting size_hint to zero (0) causes the library to make a reasonable estimate for the default local heap size.

Returns:

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

Example:

Coming Soon!

History:
Release    Change
1.8.0Function introduced in this release.

--- Last Modified: December 04, 2017 | 08:49 AM