Advertisements
QOUT()
Display a list of expressions to the console
------------------------------------------------------------------------------
Syntax
QOUT([<exp list>]) --> NIL
QQOUT([<exp list>]) --> NIL
Arguments
<exp list> is a comma-separated list of expressions (of any data
type other than array or block) to display to the console. If no
argument is specified and QOUT() is specified, a carriage return/line
feed pair is displayed. If QQOUT() is specified without arguments,
nothing displays.
Returns
QOUT() and QQOUT() always return NIL.
Description
QOUT() and QQOUT() are console functions. These are the functional
primitives that create the ? and ?? commands, respectively. Like the ?
and ?? commands, they display the results of one or more expressions to
the console. QOUT() outputs carriage return and line feed characters
before displaying the results of <exp list>. QQOUT() displays the
results of <exp list> at the current ROW() and COL() position. When
QOUT() and QQOUT() display to the console, ROW() and COL() are updated.
If SET PRINTER is ON, PROW() and PCOL() are updated instead. If <exp
list> is specified, both QOUT() and QQOUT() display a space between the
results of each expression.
You can use QOUT() and QQOUT() for console display within an expression.
This is particularly useful for blocks, iteration functions such as
AEVAL() and DBEVAL(), and in a list of statements in the output pattern
of a user-defined command definition.
Examples
. This example uses QOUT() with AEVAL() to list the contents of
a literal array to the console:
LOCAL aElements := { 1, 2, 3, 4, 5 }
AEVAL(aElements, { |element| QOUT(element) })
Files: Library is CLIPPER.LIB.
See Also: ?|?? @…SAY SET ALTERNATE SET CONSOLE SET PRINTER
Advertisements