SET ALTERNATE
 Envia a saída de console para um arquivo texto
------------------------------------------------------------------------------

 Sintaxe

     SET ALTERNATE TO [<xcArquivo>]
     SET ALTERNATE on | OFF | <xlComuta>

 Argumentos

     TO <xcArquivo> abre um arquivo texto ASCII padrao para saída, com
     uma extensao padrao (.txt).  O nome do arquivo pode opcionalmente
     incluir uma extensao, disco e/ou diretório.  <xcArquivo> pode ser
     especificado pelo próprio nome do arquivo ou por expressao caractere
     entre parênteses.  Observe que se existe um arquivo com o mesmo nome,
     ele será sobre-escrito.

     ON escreve a saída do console no arquivo texto aberto.

     OFF interrompe temporariamente o envio da saída do console ao
     arquivo texto, sem fechá-lo.

     <xlComuta> é uma expressao lógica que deve ser colocada entre
     parênteses.  O valor verdadeiro (.T.) é o mesmo que ON, é o valor falso
     (.F.) é o mesmo que OFF.

 Descriçao

     O comando SET ALTERNATE permite a você escrever a saída dos comandos do
     console em um arquivo texto.  Comandos como LIST, REPORT FORM, LABEL
     FORM, e ?, que exibem dados na tela sem referência a posiçao de linha e
     coluna, sao os chamados comandos de console.  A maioria destes comandos
     têm uma cláusula TO FILE que executa a mesma funçao que SET ALTERNATE.
     Comandos de tela completa, como @...SAY, nao podem ser enviados para um
     arquivo de disco com o comando SET ALTERNATE.  Ao invés disso, você
     pode utilizar SET PRINTER TO <xcArquivo> juntamente com SET DEVICE TO
     PRINTER para chegar a este resultado.

     SET ALTERNATE tem duas formas básicas.  A forma TO <xcArquivo > cria um
     arquivo texto DOS com uma extensao padrao de (.txt) e sobre-escreve
     qualquer outro arquivo com o mesmo nome.  Arquivos do tipo alternate
     nao sao relacionados a áreas de trabalho com somente um arquivo aberto
     de cada vez.  Para fechar um arquivo do tipo alternate, use CLOSE
     ALTERNATE, CLOSE ALL, ou SET ALTERNATE TO sem nenhum argumento.

     A forma on|OFF controla o envio da saída do console para o arquivo
     alternate corrente.  SET ALTERNATE ON inicia o envio da saída para o
     arquivo alternate.  SET ALTERNATE OFF interrompe a repetiçao da sáída
     para o arquivo alternate, mas sem fechá-lo.

 Exemplos

     Este exemplo cria um arquivo do tipo alternate e escreve os resultados
     do comando ? no arquivo para cada registro no arquivo de dados
     Customer:

     SET ALTERNATE TO Listfile
     SET ALTERNATE ON
     USE Customer NEW
     DO WHILE !EOF()
        ? Lastname, City
        SKIP
     ENDDO
     SET ALTERNATE OFF
     CLOSE ALTERNATE
     CLOSE Customer

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

See Also: CLOSE SET CONSOLE SET PRINTER FOPEN() FWRITE()