Click above to get retro games delivered to your door ever month!

Synopsis:
    #include <malloc.h>
    int  _heapmin( void );
    int _bheapmin( __segment seg );
    int _fheapmin( void );
    int _nheapmin( void );

Description:
    The  _heapmin functions attempt to shrink the specified heap to its
    smallest possible size by returning all free entries at the end of the
    heap back to the system.  This can be used to free up as much memory as
    possible before using the  system function or one of the  spawn
    functions.

    The various  _heapmin functions shrink the following heaps:

    _heapmin
        Depends on data model of the program

    _bheapmin
        Based heap specified by seg value; _NULLSEG specifies all based
        heaps

    _fheapmin
        Far heap (outside the default data segment)

    _nheapmin
        Near heap (inside the default data segment)

    In a small data memory model, the  _heapmin function is equivalent to
    the  _nheapmin function; in a large data memory model, the  _heapmin
    function is equivalent to the  _fheapmin function.  It is identical to
    the  _heapshrink function.

Returns:
    These functions return zero if successful, and non-zero if some error
    occurred.

See Also:
    _heapchk Functions, _heapenable, _heapgrow Functions, _heapset Functions, _heapshrink Functions, _heapwalk Functions

Example:
    #include <stdlib.h>
    #include <malloc.h>

    void main()
      {
        _heapmin();
        system( "chdir c:\\watcomc" );
      }

    Note the use of two adjacent backslash characters (\) within
    character-string constants to signify a single backslash.

Classification:
    WATCOM

Systems:
     _heapmin - All

    _bheapmin - DOS/16, Win/16, QNX/16, OS/2 1.x(all)
    _fheapmin - DOS/16, Win/16, QNX/16, OS/2 1.x(all)
    _nheapmin - DOS, Win, QNX, OS/2 1.x, OS/2 1.x(MT), OS/2 2.x, NT