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►
────────────────────────────────────────────────────────────────────────────
 
     The functions in the _heapset family help debug heap-related
     problems by showing free memory locations or nodes that were
     unintentionally overwritten.
 
     The _heapset functions first check for minimal consistency on the
     heap in a manner identical to that of the _heapchk functions.
     After the consistency check, the _heapset functions set each byte
     of the heap's free entries to the fill value. This known value
     shows which memory locations of the heap contain free nodes and
     where data was unintentionally written to freed memory.
 
     The various _heapset functions check and fill these heaps:
 
     Function      Heap Filled
 
     _heapset      Depends on data model of program
 
     _bheapset     Based heap specified by <seg> value;
                   _NULLSEG specifies all based heaps
 
     _fheapset     Far heap (outside default data segment)
 
     _nheapset     Near heap (inside default data segment)
 
     In large data models (compact-, large-, and huge-model programs),
     _heapset maps to _fheapset. In small data models (tiny-, small-,
     and medium-model programs), _heapset maps to _nheapset.
 
     Return Value
 
     All four routines return an int type whose value is one of the
     following manifest constants (defined in MALLOC.H): _HEAPOK,
     _HEAPEMPTY, _HEAPBADBEGIN, or _HEAPBADNODE.
                                    -♦-