diff options
Diffstat (limited to 'readme.md')
| -rw-r--r-- | readme.md | 18 |
1 files changed, 18 insertions, 0 deletions
@@ -10,7 +10,9 @@ for amd64 linux systems. - `n`: signed integer - `u`: unsigned integer - `?`: boolean flag +- `xt`: execution token - `""`: string in input buffer +- `|`: 'or' ## Glossary @@ -43,6 +45,12 @@ marks the u bytes starting at address a as executable. this is used primarily to mark the program break, which is used as the user memory space. +### `find ( a u -- a u 0 | xt -1 )` +look in the dictionary for the word a (of u characters). +a zero is returned along with the original given string +if no word was found. if a word was found, +its xt is returned along with the true flag. + ### `grow ( u -- )` grows the user memory space by u bytes. @@ -90,3 +98,13 @@ note that the string length of one byte limits a word's name to 255 characters. ## reserved registers the register `r15` is reserved for the parameter stack pointer. + +## differences from standard forth + +for the most part this forth intends to be in line with standards +but it diverges in a few notable places: + +- the most visally obvious one by far, + this forth uses lower case word names for core words. +- `find` takes `a u` instead of a counted string, + and does not return 1 for immediate words. |