Format
#include <stdlib.h> /* also in <malloc.h> */ int _heapmin(void);
Language Level: Extension
_heapmin returns all unused memory from the
default runtime heap to the operating system.
Heap-specific, debug and tiled (for OS/2) versions of this function (_uheapmin, _debug_heapmin and _theapmin) are also available. _heapmin always operates on the default heap.
Note: If you create your own heap and make it the default heap, _heapmin calls the release function that you provide to return the memory.
Return Value
_heapmin returns 0 if successful; if not,
it returns -1.
Example
This example shows how to use the
_heapmin function.
#include <stdio.h> #include <stdlib.h>
int main(void)
{
if (_heapmin())
printf("_heapmin failed.\n");
else
printf("_heapmin was successful.\n");
return 0;
/*****************************************
The output should be:
_heapmin was successful. *****************************************/ }
![]()
_debug_heapmin -- Release
Unused Memory in the Default Heap
_debug_theapmin -- Release Unused Tiled Memory
_debug_uheapmin --
Release Unused Memory in User Heap
_theapmin -- Release Unused Tiled Memory
_uheapmin --
Release Unused Memory in User Heap
<malloc.h>
<stdlib.h>