Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

 ◄Summary► ◄Example►                         ◄Up► ◄Contents► ◄Index► ◄Back►
─────Run-Time Library───────────────────────────────────────────────────────
 
     The functions in the _heapmin family minimize the heap by
     releasing unused memory in the heap to the operating system.
 
     The various _heapmin functions release unused memory in these
     heaps:
 
     Function      Heap Minimized
 
     _heapmin      Depends on data model of program
     _bheapmin     Based heap specified by seg value; _NULLSEG
                   specifies all based heaps
     _fheapmin     Far heap (outside default data segment)
     _nheapmin     Near heap (inside default data segment)
 
     With large data models (that is, compact-, large-, and huge-model
     programs), _heapmin maps to _fheapmin. In small data models
     (tiny-, small-, medium-model programs), _heapmin maps to
     _nheapmin.
 
     For _heapmin, if the supplied <seg> value is _NULLSEG, all based
     heap segments are minimized; otherwise, only the specified one is
     minimized.
 
     Based-heap segments are never freed (that is, unlinked from the
     based-heap list and released back to the operating system) by the
     _bheapmin function. The _bfreeseg function is used for that
     purpose.
 
     Return Value
 
     The _heapmin functions return 0 if the function completed
     successfully, or -1 in the case of error.
                                    -♦-