.-
help for ^ifexp^                                    (STB-41: ip23)
.-

Expansion and display of if expressions
---------------------------------------

^ifexp if^ exp [ ^, novar^label ^noval^label ^noun^abbrev ^nosp^ace
                 ^c^olor^(^{^w^hite|^b^lue|^g^reen|^y^ellow|^r^ed}^)^ ]


Description
-----------

^ifexp^ expands the tokens in an ^if^ expression and displays the fully-
expanded expression.  ^exp^ contains the expression to be expanded and is 
required (as is the ^if^ before it).  By default, the following are done:

   * variable names are expanded to variable labels (if they exist),
   * numerical values are expanded to value labels (if they exist),
   * variable names are unabbreviated (if displayed), and
   * a space is placed between tokens.

^ifexp^ is intended for use by ado-file programmers but can be invoked 
directly to interactively display an expanded ^if^ expression.


Options
-------

^novarlabel^ suppresses replacement of variable names by variable labels.

^novallabel^ suppresses replacement of numerical values by value labels.

^nounabbrev^ suppresses unabbreviation of variable names.

^nospace^ suppresses insertion of a space between tokens in the output string.

^color()^ specifies the display color for the expanded expression.  Blue is 
the default color when this option is not specified or is misspecified.


Interactive Examples
--------------------

 . ^ifexp if foreign==0&mpg>30^
 . ^ifexp if for==0 & mpg>30, noun^
 . ^ifexp if foreign==0 & mpg>30, noval novar^
 . ^ifexp if foreign==0&mpg>30, nosp color(y)^


Programming Examples
---------------------

   ^if "`if'" != "" {ifexp "`if'"}^

   ^if "`if'" != "" {ifexp "`if'", novar color(y)}^

Note: When the ^noprefix^ descriptor is used in declaring the ^if^ local macro
in the calling program, the call to ^ifexp^ must be modified as follows:

   ^if "`if'" != "" {ifexp if "`if'"}^

Author
------

      Thomas J. Steichen 
      RJRT
      steicht@@rjrt.com


Also see
--------

    STB:  STB-41 ip23