DISPLAY 
 Muestra registros en la consola
------------------------------------------------------------------------------
 Sintaxis

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

 Argumentos

     <lista exp> es la lista de valores que van a mostrarse por cada
     registro procesado.

     TO PRINTER direcciona la salida a la impresora.

     TO FILE <xcFichero> direcciona la salida al fichero indicado, que
     puede especificarse como un nombre 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 del fichero de base de datos actual que se va
     a visualizar. El valor por defecto es el registro actual, o NEXT 1. Si
     se especifica una condición, el ámbito se convierte en todo el
     fichero.

     WHILE <lCondición> especifica el conjunto de registros que cumplen
     la condición, desde el registro actual hasta que la condición deje de
     cumplirse.

     FOR <lCondición> especifica el conjunto condicional de registros
     que se van a visualizar en el ámbito dado.

     OFF suprime la visualización del número de registro.

 Descripción

     DISPLAY es un mandato de base de datos, que accede secuencialmente a
     los registros del área de trabajo actual y muestra en la consola los
     resultados de <lista exp> en formato tabular, separando cada columna
     con un espacio. El mandato no muestra cabeceras de columna ni se
     detiene a intervalos predeterminados. DISPLAY es idéntico a LIST con la
     excepción de que su ámbito por defecto es NEXT 1 en lugar de ALL.

     Cuando se invoca este mandato, la salida se envía a la pantalla y,
     opcionalmente, a la impresora y/o a un fichero. Si desea eliminar la
     salida en pantalla mientras se imprime o se escribe el fichero, utilice
     SET CONSOLE OFF antes de la línea del programa en la que esté el
     mandato DISPLAY.

 Notas

     ■ Interrupción de la salida: Para que el usuario pueda
        interrumpir la ejecución de un mandato DISPLAY pulsando una tecla,
         debe añadir en la condición FOR una condición con la función
        INKEY() que compruebe si se ha pulsado la tecla de interrupción.
         Consulte el ejemplo siguiente.

     ■ Margen de impresora: Puesto que DISPLAY es un mandato de
        consola, respeta el SET MARGIN actual al dirigir la salida a la
        impresora.

 Ejemplos

      Este ejemplo ilustra un DISPLAY simple y un DISPLAY
        condicional para la impresora:

        USE Ventas NEW
        DISPLAY DATE(), TIME(), Oficina
        DISPLAY Oficina, Vendedor FOR Cantidad > 500 TO PRINTER

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

        #define T_ESC 27
        USE Ventas INDEX Vendedor NEW
        DISPLAY Oficina, Vendedor, Cantidad WHILE ;
           INKEY() != T_ESC

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: DBEVAL() INKEY() LIST SET MARGIN