adoc/p_roll.adoc

   1 // stack.asm:   WORD p_roll, 'ROLL',fasm
   2
   3 anchor:p_roll[]
   4
   5 === Word: ROLL
   6
   7 ....
   8 Data stack: ( vu...v1 v0 u -- ...v1 v0 vu )
   9 ....
  10
  11 "ROLL" is a function word that "moves" the u:th data stack cell down
  12 from top onto the data stack while discarding it. 0 indicates the top
  13 cell; 1 indicates the second top cell making it the same as
  14 <<p_swap,SWAP>>; 2 indicates the third top cell making it the same as
  15 <<p_rot,ROT>>.
  16
  17
  18
  19