Edit "herkforth_branch

edit "herkforth_branch_tables" below.

Tips:

The first line is the page title.
Separate your paragraphs by at least one blank line.
To have a < in your text, enter <<.
To make a link put <l and <> around the wiki page name or web address. Like this: <lmy page<> NOTE: that's a lowercase ELL
To learn about other things you can do please see wiki syntax

herkforth branch tables

This stuff will change as I create more sophisticated ways of dealing with tables. But for now here's how you can make and use branch tables:

Brant tables are implemented as a bunch of branch instructions (not a list of
addresses.) You create them by just calling the words (green), then calling
fix-table. Pass the number of branches in the table to fix-table:

<c] word1 word2 word3 [ 3 fix-table<>

Probably you'll want a word that gives you the address for the branch table.
Here's one way:

<c: my-table [ create ] word1 word2 word3 [ 3 fixtable<>

You might use this like so:

<c: do-something 4 * my-table + jump ;<>

So now <c2 do-something<> would execute <cword3<>.

These have more complete code, but I still plan to improve them.

With this code you can make a table of word/key pairs. You can call a word to
search through the keys for a match, and execute it's corresponding word.

If the key is not found, the last word in the table is called <eand the key is
passed to it<>. This functions as a default action. <eDo not<> put a value
after the default.

If you are somehow sure that your key will always be found, you do not need to
supply a default. (But only do this if you are absolutely sure, because if you
don't supply a default, and search for a key that doesn't exist, it will likely
crash.)

Example of use:

At some point I'll make it so you don't need the <cexe-table-lookup<> in there.

<lherkforth<>

Anti-Robot: Please enter your favorite four digit number here: