COPY TO
 Exporta registros para um novo (.dbf) ou arquivo ASCII
------------------------------------------------------------------------------

 Sintaxe

     COPY [FIELDS <idLista Campos>] TO <xcArquivo>
        [<abrangência>] [WHILE <lCondiçao>] [FOR <lCondiçao>]
        [SDF | DELIMITED [WITH BLANK | <xcDelimitador>]]

 Argumentos

     FIELDS <idLista Campos> especifica a lista de campos a serem
     copiados para o arquivo destino.  O assumido é todos os campos.

     TO <xcArquivo> especifica o nome do arquivo destino.  O arquivo
     pode ser especificado literalmente ou como expressao caractere entre
     parênteses.  Caso SDF ou DELIMITED seja especificado, (.txt) é a
     expressao assumida.  De outra maneira, (.dbf) é assumido.

     <abrangência> define a porçao do arquivo corrente a ser copiada.  O
     assumido sao todos os registros.

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

     FOR <lCondiçao> especifica o conjunto de regsitros a ser copiado
     dentro da abrangência.

     SDF especifica o arquivo de saída como um system data format ASCII
     texto.  Registros sao de tamanho fixo, separados por carriage
     return/line feed.  Campos sao de tamanho fixo e nao há separador de
     campo.  Campos caractere sao ajustados com brancos à direita, campos
     numéricos sao ajustados com brancos à esquerda, datas sao escritas na
     forma aaaammdd, e campos lógicos sao escritos como T ou F.  A marca de
     fim de arquivo é 1Ah ou CHR(26).

     DELIMITED especifica o tipo do arquivo de saída como ASCII
     delimitado.  Os registros sao de tamanho variável, cada um separado por
     um carriage return/line feed. Os campos têm tamanho variável e sao
     separados por vírgulas.  Campos caractere sao delimitados (aspas duplas
     a nao ser que você especifique outro tipo usando WITH
     <xcDelimitador>).  Espaços de ajuste à direita e à esquerda para campos
     numéricos e caractere sao truncados, campos data sao escritos na forma
     aaaammdd, e lógicos sao escritos como T ou F.  A marca de fim de
     arquivo é 1Ah ou CHR(26).

     DELIMITED WITH BLANK identifica um arquivo ASCII texto, onde campos
     sao separados por um espaço e campos caractere nao sao delimitados.

     DELIMITED WITH <xcDelimitador> identifica um arquivo texto ASCII
     delimitado, onde os campos caractere sao delimitados pelo delimitador
     especificado.  <xcDelimitador> pode ser especificado literalmente ou
     como expressao caractere entre parênteses.

     -----------------------------------------------------------------------
     . Nota

     Caso DELIMITED WITH seja especificado em COPY ou APPEND, ele deve ser a
     última cláusula especificada.
     -----------------------------------------------------------------------

 Descriçao

     COPY TO copia todo ou parte do arquivo de dados corrente para um novo
     arquivo.  Todos os registros contidos no arquivo de dados ativo sao
     copiados a menos que limitados por <abrangência> ou a cláusula
     FOR|WHILE.  Todos registros incluindo aqueles marcados para eliminaçao
     serao copiados a menos que DELETED esteja ON ou um filtro esteja
     estabelecido.

     Registros sao copiados na ordem do índice de controle se um estiver em
     uso.  De outra forma, os registros sao copiados na sua ordem natural.

     No ambiente de rede, Clipper abre o arquivo destino EXCLUSIVE antes da
     operaçao de cópia ter início.  Leia o capítulo sobre Programando em
     Rede no livro Programando e Utilitários para maiores informaçoes.

 Exemplos

       Este exemplo demonstra COPY para outro arquivo de dados:

        USE Sales NEW
        COPY TO Temp

       Este exemplo demonstra o layout do arquivo SDF com quatro
        campos, um de cada tipo:

        USE Testdata NEW
        COPY NEXT 1 TO Temp SDF
        TYPE Temp.txt

        Resulta:

        Caractere         12.0019890801T

       Este exemplo demonstra o layout de um arquivo DELIMITED:

        COPY NEXT 1 TO Temp DELIMITED
        TYPE Temp.txt

        Resulta:

        "Caractere",12.00,19890801,T

       Este exemplo demonstra o layout de um arquivo DELIMITED com
        um delimitador diferente:

        COPY NEXT 1 TO Temp DELIMITED WITH '
        TYPE Temp.txt

        Resulta:

        'Caractere',12.00,19890801,T

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

See Also: APPEND FROM COPY FILE COPY STRUCTURE SET DELETED