Checks for an existing definition of an operand and returns its definition type.
Syntax |
 |
The BOUND function uses the name in operand to check for an existing
definition for that name. The type of the definition is returned
in a string. The following table lists all possible types:
- NUMBER
A valid numeric expression (in current input base)
- ENV
A predefined environment variable
- VAR
A user defined variable
- FUNC
A predefined function
- MACRO
A user defined macro
- PROCEDURE
A valid procedure name (in current mode)
- ALIAS
An alias definition
- COMMAND
A command name
- WINDOW_COMMAND
A window command name
- UNDEFINED
No definition is currently bound
The table is searched in order from top to bottom. The first type which
matches is returned. Additional matches may be possible but are not tested.
Examples |
|
$nmdebug > if bound('list') <> 'VAR' then var list slowbuildlist('ALL')
|
BOUND is often used to determine if a particular variable has been defined. In
this example, which might typically be found in a macro, BOUND is used to test
for the prior definition of the variable named "list". If the variable
has not yet been defined, then it is created and assigned the return
value from the macro named slowbuildlist.
$nmdebug > wl bound('123')
NUMBER
$nmdebug > wl bound('add')
NUMBER
|
123 and ADD are both numbers (in the current input base).
$nmdebug > wl bound('s')
ENV
|
S is an environment variable (the CM S register). Note that S is also
a command name (Single Step), but only the first match is returned.
$nmdebug > wl bound('BOUND')
FUNC
|
BOUND is a function (in fact, the one this page is describing).
$nmdebug > wl bound('slowbuildlist')
MACRO
|
SLOWBUILDLIST is a user defined macro.
$nmdebug > wl bound('12w')
UNDEFINED
|
12w is undefined. No existing definition for 12w could be located.
