www.delorie.com/gnu/docs/gforth/gforth_109.html

search

	Buy GNU books!

Gforth Manual

5.9.10 Aliases

The defining word Alias allows you to define a word by name that has the same behaviour as some other word. Here are two situation where this can be useful:

• When you want access to a word's definition from a different word list (for an example of this, see the definition of the Root word list in the Gforth source).
• When you want to create a synonym; a definition that can be known by either of two names (for example, THEN and ENDIF are aliases).

Like deferred words, an alias has default compilation and interpretation semantics at the beginning (not the modifications of the other word), but you can change them in the usual ways (immediate, compile-only). For example:

: foo ... ; immediate ' foo Alias bar \ bar is not an immediate word ' foo Alias fooby immediate \ fooby is an immediate word

Words that are aliases have the same xt, different headers in the dictionary, and consequently different name tokens (see section 5.11 Tokens for Words) and possibly different immediate flags. An alias can only have default or immediate compilation semantics; you can define aliases for combined words with interpret/compile: -- see 5.10.1 Combined Words.

doc-alias