You are viewing an old version of this page. View the current version.
Version 1 Next »
Specifies the anticipated maximum size of a local heap
H5P_SET_LOCAL_HEAP_SIZE_HINT ( gcpl_id, size_hint )
herr_t H5Pset_local_heap_size_hint( hid_t gcpl_id, size_t size_hint )
Replace this text with the C++ Function Signature
Replace this text with the JAVA Function Signature
|hid_t ||IN: Group creation property list identifier|
|size_t ||IN: Anticipated maximum size in bytes of local heap|
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
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.
size_hint to zero (
0) causes the library to make a reasonable estimate for the default local heap size.
Returns a non-negative value if successful; otherwise returns a negative value.
|1.8.0||Function introduced in this release.|