Was this helpful?
.Ulcharacter Statement--Set Underline Character
The .ulcharacter statement sets the underlining character to any single character when output is to a file or printer.
This statement has the following format:
.ulcharacter | .ulchar | .ulc 'c' | expression
The parameters for the .ulcharacter statement are as follows:
c
Any single character, subsequently used as the underlining character. The default underlining character is the underscore (_) for reports written to a file or printer, and none for reports written to the screen.
The character c must be a single character enclosed in quotes.
expression
A character expression that evaluates to any single character, subsequently used as the underlining character. Precede all variables that are part of the expression with a dollar sign ($). For more information, see the chapter "Report-Writer Expressions and Formats."
Description
With the .ulcharacter statement, you can specify an alternate underlining character or an expression that evaluates to an underlining character during report runtime. Underlining occurs only in reports written directly to a file or printer. Report-Writer ignores underlines when displaying a report on the screen and in reports sent to a file or printer from the screen.
The character remains in effect until Report-Writer encounters another .ulcharacter statement in the report.
Report-Writer prints underscoring (_) on the same line as the text. If any other character, such as a hyphen (‑), is specified with the .ulcharacter statement, Report-Writer prints underlining as a second line immediately below the underlined text.
Example
To produce the following:
Underline me
--------- --
and me
=== ==
Use the following specifications:
.underline
        .ulcharacter '-' .pr 'Underline me' .newline
        .ulcharacter '=' .pr 'and me' .newline
.nounderline
Last modified date: 11/28/2023