LIST
 Lista registros para o console
------------------------------------------------------------------------------

 Sintaxe

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

 Argumentos

     <lista expr> é a lista de expressoes a serem avaliadas e exibidas
     para cada registro processado.

     TO PRINTER envia a saída para a impressora.

     TO FILE <xcArquivo> ecoa a saída para o arquivo pedido, que pode
     ser especificado literalmente ou por uma expressao caractere entre
     parênteses. Se nao for especificada extensao, o padrao assumido será
     (.txt).

     <abrangência> é a parte do arquivo de dados corrente a ser
     listada.  O padrao é todos (ALL) os registros.

     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 condicional de registros a
     serem listados dentro da abrangência.

     OFF evita que os números de registro sejam exibidos.

 Descriçao

     LIST é um comando de console que acessa sequencialmente registros na
     área de trabalho corrente, exibindo os resultados de uma ou mais
     expressoes para cada registro acessado.  A saída é em formato tabular
     com cada coluna separada por um espaço.  LIST é idêntico a DISPLAY a
     nao ser pelo alcance padrao, que é todos (ALL) no primeiro e próximo
     (NEXT 1) no último.

     Quando chamada, a saída é enviada para a tela e opcionalmente para a
     impressora e/ou para um arquivo.  Para evitar que a saída seja exibida
     na tela enquanto estiver sendo impressa ou sendo enviada para um
     arquivo, use o comando SET CONSOLE OFF antes de usar o comando LIST.

 Notas

       Interrompendo LIST: Para interromper um comando LIST, use
        a funçao INKEY() como parte da condiçao FOR verificando a
        interrupçao ao toque de uma tecla.

       Margem da impressora: Sendo LIST um comando de console,
        ele obedece ao especificado em SET MARGIN para a saída ecoada para a
        impressora.

 Exemplos

       Neste exemplo, uma listagem simples é seguida por uma
        listagem condicional para a impressora:

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

       Este exemplo demonstra como interromper o comando LIST usando
        a funçao INKEY() para verificar se o usuário teclou Esc:

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

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

See Also: ?|?? DISPLAY