ECHO

From Recital Documentation Wiki
Jump to: navigation, search

Purpose

Evaluate expression and output result


Syntax

ECHO <exp> [, <exp>]

[AT <expN>]

[FUNCTION <expC1>]

[PICTURE <expC2>]


See Also

?, ??, @...GET, @...SAY, ACCEPT, INPUT, SET SPACE, TRANSFORM(), WAIT


Description

The ECHO command evaluates the expression and displays the results on the same line, no carriage return/line feed sequence is output unless the <exp> is a character expression and contains the 'C' style escapes as shown below. If more than one expression is specified and SET SPACE is ON, a single space is output between each expression. If SET SPACE is OFF, the expressions are output with no space in between.

The following escapes can be included in <exp> if it is a character expression:


Escape Description
\t Tab
\n New line
\r Carriage return

The ECHO command also supports php-style $variable and {expression} substitutions in character strings.


Clause Description
AT <expN> You may optionally specify the column at which the expression will be output with the AT <expN> clause.
PICTURE <expC1> The PICTURE clause supports all picture template symbols listed in the @...SAY command.
FUNCTION <expC2> The FUNCTION qualifier allows picture functions to be specified. Normally this can be done with the PICTURE qualifier by preceding the picture with '@'. If the FUNCTION qualifier is used the '@' is not needed.


Example

echo "price" at 10 picture "@!",1234.56 picture "$9,999.99"
echo "-----\n" at 10
          PRICE $1,234.56
          -----
 
// php-style $variable and {expression} substitution
m_date = date()
echo "Today's date is {m_date}\n"


Products

Recital Server, Recital