NOTES FOR USE OF THE WORD LIST
These words are used for programming the TDS2020F and incorporate the latest
ANS Forth. There are 509 words in all, contained either in the TDS2020F Forth ROM or in one of two files,
#ANS.TDS (ANS Forth words) or #EXTEND.TDS (non-ANS words specific to the
TDS2020F). All the words are listed
in alphabetical and dictionary orders below, followed by individual
definitions.
Word definitions are given in strict ASCII order. In this
section, 'ANS' appears alongside all ANS Forth words. Where words are
found in the separate files, this is also shown. The stack conditions for each
word before and after are shown thus:
stack before - stack
after
The top of the stack is on the right. Where the stack effect
is different during compilation and run-time, both are given.
When the return stack changes it is indicated like this:
R: n1 n2 - n1 n3
If text is needed following the word in question it is given
in single quotes like this:
'<spaces>name' -
In this example, from the definition of ['] ,
there are no stack effects but text consisting of at least one space, then a
name, then one space is required after the word, like this: ['] XYZ
STACK EFFECT ABBREVIATIONS
|
Symbol
|
Data type
|
|
+d
|
non-negative 32-bit
double-cell number
|
|
+n
|
non-negative 16-bit
single-cell number
|
|
?1 ?2
|
any data
type. May be an undetermined number
|
|
|
of stack entries of unspecified
type
|
|
a or addr
|
address
|
|
aa or a-addr
|
aligned address
|
|
b
|
16-bit
number of which only the lower byte is
|
|
|
of interest
|
|
c or char
|
ASCII character
|
|
ca or c-addr
|
character-aligned address
|
|
case-sys
|
CASE structures
|
|
ccc
|
ASCII text
|
|
colon-sys
|
definition compilation
|
|
d
|
32-bit signed double-cell
number (two's complement)
|
|
dest
|
control-flow destinations
|
|
do-sys
|
do-loop structures
|
|
eol
|
end of line character (hex 0D)
|
|
false
|
false flag (0)
|
|
flag
|
Boolean
flag. 0 = false, non-zero = true,
|
|
|
flag = -1 when true flag left by a
word
|
|
lfa
|
link field address
|
|
loop-sys
|
loop-control parameters
|
|
n
|
16-bit signed single-cell
number
|
|
nest-sys
|
definition calls
|
|
nfa
|
name field address
|
|
of-sys
|
OF structures
|
|
orig
|
control-flow origins
|
|
pfa
|
parameter field address (body of a
definition)
|
|
r/l
|
right/left flag (for LCDs)
|
|
s/c
|
shift cursor flag (for LCDs)
|
|
true
|
true flag (-1)
|
|
u
|
16-bit unsigned single-cell
number
|
|
ud
|
32-bit unsigned double-cell
number
|
|
x
|
unspecified cell
|
|
xd
|
unspecified cell pair
|
|
xt
|
execution token (code field
address, cfa)
|
|
wid
|
word list identifier
|
|