tForth is a simple implementation of some basic Forth language capabilities. Where possible, I have followed the Forth standard:. My intent was to simultaneously learn Forth and Rust.
The program relies on a Rust binary, and a source file containing library functions (currently quite small). The program should be installed anywhere, but the default location for the library file is '~/.tforth/corelib.fs'.
tForth responds to the following command line options:
| Command Line | notes | |
|---|---|---|
| Usage: tforth [OPTIONS] | ||
| Options: | ||
| --debuglevel | [possible values: error, warning, info, debug] | |
| --library | Allows a library other than the standard core library to be loaded at startup. | |
| --file | Allows a user-defined tForth code file to be loaded after (or without) the library file. | |
| --nocore | Suppresses loading of a core / library file | |
| -h, --help | Print help | |
| -V, --version | Print version' |
tForth is an interactive command-line program that can be used like a reverse-polish calculator. Operands (integers) are placed on the calculation stack. Operators consume and operate on stack elements. For example:
| Code | Example |
|---|---|
| 2 | places 2 on the stack |
| 3 4 | places 3, then 4 on the stack; |
| * | multiplies 3 by 4, leaving the result on the stack |
| + | adds the top of the stack to 2 (2nd to top of stack) |
| 14 | The result is left on the stack. |
| .s | is a tForth word to print the contents of the stack. |