adoc/p_execute.adoc

   1 // rrqforth.asm:        WORD p_execute,'EXECUTE',fasm
   2
   3 anchor:p_execute[]
   4
   5 === Word: EXECUTE
   6
   7 ....
   8 Data stack: ( cfa -- )
   9 ....
  10
  11 "EXECUTE" is a function word that transfers the execution to the
  12 indicated "Code Field Address", which typically is the CFA of an
  13 RRQFORTH word with the CFA cell containing a jump address for the code
  14 that implements the execution semnatics of the word.
  15
  16 The following execution semantics are predefined:
  17
  18  * assembler implemented words constitute their own execution
  19    semantics;
  20
  21  * <<p_doforth>> implements the FORTH machine. This treats the word
  22    content as a succession of cells that hold the cfa pointers for the
  23    words that make of the definition. As is customary in FORTH
  24    machines, the advance through that succession is provided by each
  25    word code ending making an explicit jump to its successor. The
  26    <<p_return_stack,RETURN-STACK>> serves as a call stack for tracking
  27    the nesting of FORTH executions by saving the "addresses" of the
  28    successor cells.
  29
  30  * <<p_dodoes>> implements the variation of starting the FORTH
  31    execution somewhere within a definition rather than at the
  32    beginning.
  33
  34  * <<p_dostring>>, <<p_dovalue>> and <<p_dovariable>> implement
  35    different common ways of using word content other the as FORTH
  36    definitions.
  37
  38