[<<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