Queries data to estimate required local heap or object header size
H5P_GET_EST_LINK_INFO ( gcpl_id, est_num_entries, est_name_len )
|IN: Group creation property list identifier|
|OUT: Estimated number of links to be inserted into group|
|OUT: Estimated average length of link names|
H5P_GET_EST_LINK_INFO queries a group creation property list,
gcpl_id, for its “estimated number of links” and “estimated average name length” settings.
The estimated number of links anticipated to be inserted into a group created with this property list is returned in
The estimated average length of the anticipated link names is returned in
The values for these two settings are multiplied to compute the initial local heap size (for old-style groups, if the local heap size hint is not set) or the initial object header size for (new-style compact groups; see Group implementations in HDF5). Accurately setting these parameters will help reduce wasted file space.
A value of
0 (zero) in
est_num_entries will prevent a group from being created in the compact format.
See Group implementations in HDF5 in the H5G API introduction for a discussion of the available types of HDF5 group structures.
Returns a non-negative value if successful; otherwise returns a negative value.
|1.8.0||Function introduced in this release.|
--- Last Modified: August 06, 2019 | 01:38 PM