adoc/p_allot.adoc

   1 // compile.asm: WORD p_allot,'ALLOT',fasm
   2
   3 anchor:p_allot[]
   4
   5 === Word: ALLOT
   6
   7 ....
   8 Data stack: ( n -- )
   9 ....
  10
  11 "ALLOT" is a function word that merely increments the <<p_here,HERE>>
  12 variable with +n+ so as to claim that amount of the heap.
  13
  14 ====
  15 .Word: ALLOT
  16 [caption='Defintion concept {counter:exec}: ']
  17 ----
  18 : ALLOT HERE @ + HERE ! ;
  19 ----
  20 ====
  21
  22 ====
  23 .Usage example
  24 ****
  25 HERE @ 16 ALLOT ( -- p ; Claiming 16 bytes )
  26 ****
  27 ====
  28
  29 See also <<p_colon,:>>, <<p_here,HERE>>, <<p_get,@>>, <<p_plus,+>>,
  30 <<p_put,!>> and <<p_semicolon,;>>.
  31