LIST
 Lista registros en la consola
------------------------------------------------------------------------------
 Sintaxis

     LIST <lista exp>
        [TO PRINTER] [TO FILE <xcFichero>]
        [<ámbito>] [WHILE <lCondición>]
        [FOR <lCondición>] [OFF]

 Argumentos

     <lista exp> es la lista de expresiones que se desea evaluar y
     mostrar por cada registro procesado.

     TO PRINTER envía la salida a la impresora.

     TO FILE <xcFichero> envía la salida al nombre de fichero indicado;
     puede especificarse como un nombre de fichero literal o como una
     expresión de caracteres encerrada entre paréntesis. Si no se especifica
     una extensión, se añade .txt.

     <ámbito> es la parte de la base de datos actual que se desea
     listar. Por defecto se listan todos los registros (ALL).

     WHILE <lCondición> especifica el conjunto de registros que deben
     cumplir la condición desde el registro actual hasta que no se cumpla.

     FOR <lCondición> especifica un conjunto condicional de registros
     dentro del ámbito indicado.

     OFF suprime la visualización de los números de registro.

 Descripción

     LIST es un mandato de consola que accede secuencialmente a los
     registros en el área de trabajo actual, mostrando los resultados de una
     o más expresiones por cada registro al que se acceda. La salida tiene
     formato tabular separando cada columna por un espacio. LIST es idéntico
     a DISPLAY excepto en que su ámbito, por defecto, es ALL en vez de NEXT
     1.

     Cuando se invoca, la salida se envía a la pantalla y, opcionalmente, a
     la impresora y/o a un fichero. Para suprimir la salida por pantalla
     mientras se imprime o se envían datos a un archivo, establezca SET
     CONSOLE OFF antes de invocar el mandato LIST.

 Notas

     ■ Interrupción de LIST: Para que el usuario pueda interrumpir
        LIST, debe utilizar INKEY() como parte de la condición FOR para
        comprobar la pulsación de una tecla de interrupción. Consulte el
        ejemplo siguiente.

     ■ Margen de impresión: LIST respeta los valores actuales de SET
        MARGIN en la salida a la impresora.

 Ejemplos

      En este ejemplo, una lista sencilla va seguida de una lista
        condicional para la impresora:

        USE Ventas
        LIST DATE(), TIME(), Sucursal
        LIST Sucursal, Vendedor FOR Cantidad > 500 TO PRINTER

      Este ejemplo interrumpe LIST utilizando INKEY() para comprobar
        si el usuario ha pulsado la tecla Esc:

        #define K_ESC    27
        USE Ventas INDEX Vendedor NEW
        LIST Sucursal, Vendedor, Cantidad WHILE INKEY() != K_ESC

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: ?|?? DISPLAY