Skip to content

Showln

See Also: Show, Write, Writeln, Fundamental Data Types, Expression Syntax

Purpose

To display a line of characters to the screen in a special "character-mode" display box that deactivates when its Close button is pressed. This command is intended for development purposes only; it should not be used in finished applications.

Syntax

showln
[value... value]

Argument Explanation

value may be of any primitive data type or an expression.

What It Does

Showln outputs the value of value (if used) to a special-purpose object displayed in a dialog when the first show or showln command is executed. If the total length of data output exceeds the width of the object, the display will wrap, and the cursor will be placed at the next line following the last line on which data is displayed. The dialog remains displayed and shows successive show and showln commands until its Close button is pressed.

This command is intended for development purposes only; it should not be used in finished applications.

To showln literal information, place it inside single or double quotation marks. To showln the contents of a variable, name the variable without quotation marks.

showln "The process has completed."

In this example, the prompt "The process has completed." is displayed.

string sDescription
move "Tank, medium" to sDescription
showln sDescription

In this example, the value of sDescription ("Tank, medium") is displayed.

Different data types can be intermingled on a single showln command line.

showln "Total Amount: $ " nTotal

In this example, the legend "Total Amount: $" is displayed, followed by the value of nTotal, and the cursor is placed at the beginning of the next line.

Notes

  • Showln outputs only to the screen. For output to the printer or a file, use the writeln command.

  • The show and showln commands display only seven significant digits of values, along with the sign and, for Real values of absolute value greater than 9,999,999 or less than 0.0001, the exponent. Show and showln display numbers of absolute value up to 99,999,999,999,999, and truncate on the left without reporting an error above that point. To the right of the decimal point, show and showln truncate displays of numbers to the right of the seventh digit after the decimal point, and for Reals, they round the seventh digit.