[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 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
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson