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

 DISPOSE                Remove Variable from Heap Space               pp 124

 Syntax:  Dispose (PtrVar) ;

 Type:    Pointer

 Form:    Procedure

 Purpose: Dispose allows dynamic memory used by a specific point variable
          to be reclaimed for new use.  This is opposed to Mark/Release
          which releases the entire heap from the specified pointer variable
          and upward.

 Notes:   Dispose and Mark/Release must NOT be used in the same program.
          Use of dispose can create free areas of heap space interspersed
          with allocated areas.  Subsequent calls to NEW will reuse these
          areas if the new pointer fits in the free space.



 Usage:
       VAR
          PtrVar : ^Integer ;

       BEGIN
          Dispose (PtrVar)  ;
       END.