[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 LIST
 List records to the console
------------------------------------------------------------------------------
 Syntax

     LIST <exp list>
        [TO PRINTER] [TO FILE <xcFile>]
        [<scope>] [WHILE <lCondition>]
        [FOR <lCondition>] [OFF]

 Arguments

     <exp list> is the list of expressions to be evaluated and displayed
     for each record processed.

     TO PRINTER echoes output to the printer.

     TO FILE <xcFile> echoes output to the specified file name and can be
     specified either as a literal file name or as a character expression
     enclosed in parentheses.  If an extension is not specified, .txt is
     added.

     <scope> is the portion of the current database file to LIST.  The
     default is ALL records.

     WHILE <lCondition> specifies the set of records meeting the
     condition from the current record until the condition fails.

     FOR <lCondition> specifies the conditional set of records to LIST
     within the given scope.

     OFF suppresses the display of record numbers.

 Description

     LIST is a console command that sequentially accesses records in the
     current work area, displaying the results of one or more expressions for
     each record accessed.  The output is in tabular format with each column
     separated by a space.  LIST is identical to DISPLAY with the exception
     that its default scope is ALL rather than NEXT 1.

     When invoked, output is sent to the screen and, optionally, to the
     printer and/or a file.  To suppress output to the screen while printing
     or echoing output to a file, SET CONSOLE OFF before the LIST invocation.

 Notes

     .  Interrupting LIST: So the user may interrupt a LIST, use
        INKEY() as part of the FOR condition to test for an interrupt key
        press.  See the example below.

     .  Printer margin: LIST honors the current SET MARGIN for output
        echoed to the printer.

 Examples

     .  In this example, a simple list is followed by a conditional
        list to the printer:

        USE Sales
        LIST DATE(), TIME(), Branch
        LIST Branch, Salesman FOR Amount > 500 TO PRINTER

     .  This example interrupts LIST using INKEY() to test whether the
        user pressed the Esc key:

        #define K_ESC     27
        USE Sales INDEX Salesman NEW
        LIST Branch, Salesman, Amount WHILE INKEY() != K_ESC

 Files   Library is CLIPPER.LIB.


See Also: ?|?? DISPLAY
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson