DISPLAY
 Mostra registros no console
------------------------------------------------------------------------------

 Sintaxe

     DISPLAY <lista expr>
        [TO PRINTER] [TO FILE <xcArquivo>]
        [<abrangência>] [WHILE <lCondiçao>] [FOR <lCondiçao>]
        [OFF]

 Argumentos

     <lista expr> é a lista de valores a ser mostrada para cada registro
     processado.

     TO PRINTER envia a saída para a impressora.

     TO FILE envia a saída para <xcArquivo>, o qual pode ser
     especificado literalmente ou por expressao caractere entre parênteses.
     Se nao for especificada extensao, esta será assumida como (.txt).

     <abrangência> é a parte do arquivo de dados corrente a ser
     mostrada. O padrao é o registro corrente ou o próximo (NEXT 1).  Caso
     seja especificada uma condiçao, a abrangência passa a ser todos (ALL).

     WHILE <lCondiçao> especifica o conjunto de registros que atendem a
     condiçao do registro corrente até que a condiçao seja falsa.

     FOR <lCondiçao> especifica o conjunto de registros condicional a
     serem exibidos dentro da abrangência.

     OFF suprime a visualizaçao do número do registro.

 Descriçao

     O comando DISPLAY acessa sequencialmente registros na área de trabalho
     corrente, enviando os resultados da <Lista Expr> para o console num
     formato tabular, sendo que cada coluna é separada por um espaço.  O
     comando nao mostra cabeçalhos de colunas nem faz pausa a intervalos
     predeterminados.  O comando DISPLAY é idêntico ao comando LIST a nao
     ser pelo fato de que seu alcance padrao é NEXT 1 em lugar de ALL.

     Quando chamada, a saída é enviada à tela e, opcionalmente, à impressora
     e/ou um arquivo.  Para evitar que a saída apareça na tela enquanto
     estiver sendo impressa ou enviada para um arquivo, use o comando SET
     CONSOLE OFF antes da linha de comando do DISPLAY.

 Notas

       Interrupçao da saída: Para interromper o comando DISPLAY,
        use a funçao INKEY() como parte da condiçao FOR para verificar se a
        interrupçao acontece quando uma tecla for acionada.

       Margem da Impressora: Sendo DISPLAY um comando do
        console, ele obedece ao que tiver sido definido pelo comando SET
        MARGIN para a saída a ser enviada para a impressora.

 Exemplos

       Este exemplo ilustra um DISPLAY simples, e um DISPLAY
        condicional para a impressora.

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

       Este exemplo demonstra como interromper um DISPLAY usando a
        funçao INKEY() para verificar se o usuário pressionou Esc:

        #define K_ESC  27
        USE Sales NEW
        DISPLAY Branch, Salesman, Amount FOR INKEY() != K_ESC

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

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