Here is a final example of using %NRSTR. Suppose you wanted a text string to include
the name of a macro function: This is the result of %NRSTR. Here is the
%put This is the result of %nrstr(%nrstr);
You must use %NRSTR to mask the % sign at compilation, so the macro processor does
not try to invoke %NRSTR a second time. If you did not use %NRSTR to mask the
string %nrstr, the macro processor would complain about a missing open parenthesis
for the function.
%BQUOTE and %NRBQUOTE Functions
Using %BQUOTE and %NRBQUOTE Functions
%BQUOTE and %NRBQUOTE mask values during execution of a macro or a macro
language statement in open code. These functions instruct the macro processor to resolve
a macro expression as far as possible and mask the result, issuing any warning messages
for macro variable references or macro invocations that it cannot resolve. These
functions mask all the characters that %STR and %NRSTR mask with the addition of
unmarked percent signs; unmatched, unmarked single and double quotation marks; and
unmatched, unmarked opening and closing parentheses. That means that you do not have
to precede an unmatched quotation mark with a % sign, as you must when using %STR
The %BQUOTE function treats all parentheses and quotation marks produced by
resolving macro variable references or macro calls as special characters to be masked at
execution time. (It does not mask parentheses or quotation marks that are in the
argument at compile time.) Therefore, it does not matter whether quotation marks and
parentheses in the resolved value are matched; each one is masked individually.
The %NRBQUOTE function is useful when you want a value to be resolved when first
encountered, if possible, but you do not want any ampersands or percent signs in the
result to be interpreted as operators by an %EVAL function.
If the argument of the %NRBQUOTE function contains an unresolvable macro variable
reference or macro invocation, the macro processor issues a warning message before it
masks the ampersand or percent sign (assuming the SERROR or MERROR system
option, described in “System Options for Macros” on page 353 is in effect). To suppress
the message for unresolved macro variables, use the %SUPERQ function (discussed
later in this section) instead.
The %BQUOTE and %NRBQUOTE functions operate during execution and are more
flexible than %STR and %NRSTR. Therefore, %BQUOTE and %NRBQUOTE are
good choices for masking strings that contain macro variable references.
Examples Using %BQUOTE
In the following statement, the %IF-%THEN statement uses %BQUOTE to prevent an
error if the macro variable STATE resolves to OR (for Oregon), which the macro
processor would interpret as the logical operator OR otherwise:
%if %bquote(&state)=%str(OR) %then %put Oregon Dept. of
%BQUOTE and %NRBQUOTE Functions 91