You are viewing an old version of this page. View the current version.
Resizes and if required, re-allocates memory that will later be freed by the HDF5 library.
void *H5resize_memory( void *mem, size_t size )
|IN: Pointer to a buffer to be resized. |
|IN: New size of the buffer, in bytes.|
H5resize_memory takes a pointer to an existing buffer and resizes the buffer to match the value in
size. If necessary, the buffer is reallocated. If
0, the buffer is released.
The input buffer must either be
NULL or have been allocated by
H5allocate_memory since the input buffer may be freed by the library.
For certain behaviors, the pointer
mem may be passed in as
This function is intended to have the semantics of
|Resizes buffer. |
Returns pointer to resized buffer.
|Allocates memory using HDF5 Library allocator. |
Returns pointer to new buffer.
|Frees memory using HDF5 Library allocator. |
|Returns NULL (undefined in C standard).|
realloc(), which allows for a “special” pointer to be returned instead of
NULL, this function always returns
NULL on failure or when
At this time, the only intended use for this function is to resize or reallocate memory that will be returned to the library (and eventually to the user) as a data buffer from a third-party HDF5 filter.
On success, returns pointer to resized or reallocated buffer or returns
NULL on failure.
|1.8.15||C function introduced with this release.|