adoc/p_allot.adoc

   1 anchor:p_allot[]
   2
   3 Word: ALLOT
   4 -----------
   5
   6 ----
   7 compile.asm:    WORD p_allot,'ALLOT',fasm
   8 ----
   9
  10 Data stack: ( n -- )
  11
  12 "ALLOT" is a function word that merely increments the "HERE" variable
  13 with +n+ so as to claim that amount of the allocation space.
  14
  15 .Execution semantics expressed in RRQFORTH
  16 ====
  17 : ALLOT
  18   HERE @ + HERE !
  19 ;
  20 ====
  21
  22 .Usage example
  23 ====
  24 HERE @ 16 ALLOT ( -- p ; Claiming 16 bytes )
  25 ====
  26