_heapmin - Release Unused Memory from Default Heap

Syntax

#include <stdlib.h>  /* also in <malloc.h> */
int _heapmin(void);

Description

• heapmin returns all unused memory from the default run-time heap to the operating system.

  Heap-specific versions of this function (_uheapmin) 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.

Returns

• heapmin returns 0 if successful; if not, it returns -1.
Example Code

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.
   ****************************************************************************/
}

Related Information

• Managing Memory" in the VisualAge C++ Programming Guide
  
• uheapmin

---

[Back: _heapchk - Validate Default Memory Heap]
[Next: _heapset - Validate and Set Default Heap]