ArborX


lookup

Longname: lookup   Open the Documentation Legend
Released: 7.80 
Created: 7.80 
See also: var getvar Technote: 0080

Summary
A keyword used with function variables: ^[funcname parameter(s)]. This syntax can be used anywhere that a regular 3B2 variable can be used: in show strings, in scripts, in expressions, etc. Function variables are a V8 feature that uniforms variable use and functions into a readable syntax. The 'lookup' function enables you to lookup a 3B2 keyword defined in the ssys.3ad system file to see if its defined/enabled, retrive its possition in the group or give it a temporary alias.
Example extract

The following show string will display the current value of the th command (text height).

 <?show ^[prop th]?>

Syntax (8.00)
verb_group:n

Number of the verb group in which the keyword is placed which you wish to lookup.

name:s

Name of the keyword itself.

alias:s

Alias to apply to the keyword.

If you did the following, you would get '12' as 'ttagmk' is entry number 12 in ssys group 1002 (note that the numbers start from 0). If the name is not found, it returns -1.

 <?show $^[lookup 1002,ttagmk]>

It can also be used to create an alias for a macro or other keyword. For example, to create a 'go' alias for 'tpgoto' simply use this macro and the function variable 'lookup':

 uverb 1002,^[lookup 1002,tpgoto],"go"^

Document created on 06-Jan-2005 (revision 1)