Reclaims the variable length (VL) datatype memory buffers
Procedure:
H5T_RECLAIM ( type_id, space_id, dxpl_id, buf )
Signature:
herr_t H5Treclaim ( hid_t type_id, hid_t space_id, hid_t dxpl_id, void *buf )
Parameters:
hid_t type_id | IN: Identifier of the datatype |
hid_t space_id | IN: Identifier of the dataspace |
hid_t dxpl_id | IN: Identifier of the data transfer property list used to create the buffer |
void *buf | IN: Pointer to the buffer to be reclaimed |
Description:
H5T_RECLAIM reclaims memory buffers created to store VL datatypes. It only frees the variable length data in the selection defined in the dataspace specified by space_id. The dataset transfer property list dxpl_id is required to find the correct allocation and/or free methods for the variable length data in the buffer.
Returns:
Non-negative on success, negative on failure
Example:
History:
| Release | Change |
|---|
| 1.12.0 | Function introduced in this release |
--- Last Modified: November 14, 2019 | 10:28 AM
