adoc/p_rot.adoc

   1 // stack.asm:   WORD p_rot, 'ROT',fasm
   2
   3 anchor:p_rot[]
   4
   5 === Word: ROT
   6
   7 ....
   8 Data stack: ( v1 v2 v3 -- v2 v3 v1 )
   9 ....
  10
  11 "ROT" is a function word that "rotates" the top three data stack cells
  12 such that the third becomes the first while the second becomes third
  13 and the first becomes the second.
  14
  15 See also <<p_roll,ROLL>>.