7.3 SYMBOL COMMANDS

The following are the relevant commands:

DEFINE SYMBOL

usage:

DEFINE SYMBOL symbol_name = string

 

SHOW SYMBOL

usage:

SHOW SYMBOL/ALL
SHOW SYMBOL symbol_name
SHOW SYMBOL partial_name

 

CANCEL SYMBOL

usage:

CANCEL SYMBOL/ALL
CANCEL SYMBOL symbol_name

Legal symbol names must begin with a letter and contain only letters, digits, underscores, and dollar signs.

To invoke symbol substitution‚ the replacement of the symbol name with its (text) value‚ within a Ferret command include the name of the symbol preceded by a dollar sign in parentheses.

For example,

yes? DEFINE SYMBOL hi = hello everyone
yes? MESSAGE ($hi) ! issues "hello everyone" msg

It is also possible to nest symbol definitions, as the following commands illustrate:

yes? DEFINE SYMBOL label_2 = My test label
yes? DEFINE SYMBOL number = 2
yes? SAY ($label_($number))
My test label