COPY TO
 Exporta registros a un nuevo fichero de base de datos .dbf o de texto ASCII
------------------------------------------------------------------------------
 Sintaxis

     COPY [FIELDS <idLista campos>] TO <xcFichero>
        [<ámbito>] [WHILE <lCondición>] [FOR <lCondición>]
        [SDF | DELIMITED [WITH BLANK | <xcDelimitador>] |
        [VIA <xcControlador]]

 Argumentos

     FIELDS <idLista campos> especifica la lista de campos que se van a
     copiar en el fichero destino. El valor por defecto es todos los
     campos.

     TO <xcFichero> especifica el nombre del fichero destino. El nombre
     de fichero puede especificarse como nombre de fichero en forma literal
     o como expresión de caracteres encerrada entre paréntesis. Si se
     especifica SDF o DELIMITED, la extensión por defecto es .txt. En otros
     casos, la extensión por defecto es .dbf.

     <ámbito> define la sección del fichero de base de datos actual que
     se va a copiar. El valor por defecto es todos los registros (opción
     ALL).

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

     FOR <lCondición> especifica el grupo de registros condicional que
     se va a copiar dentro del ámbito dado.

     SDF especifica el tipo de fichero de salida como fichero de texto
     ASCII en Formato de Datos del Sistema. Los registros y los campos
     tienen una longitud fija.

     DELIMITED especifica el tipo de fichero de salida como fichero de
     texto ASCII delimitado, en el que los campos de caracteres están
     indicados entre dobles comillas (delimitador por defecto). Los
     registros y los campos tienen una longitud variable.

     DELIMITED WITH BLANK identifica un fichero de texto ASCII en el que
     los campos están separados por un espacio y los campos de caracteres no
     tienen delimitadores.

     DELIMITED WITH <xcDelimitador> identifica un fichero de texto ASCII
     delimitado en el que los campos de caracteres están delimitados por el
     delimitador especificado. <xcDelimitador> puede especificarse como
     carácter en forma literal o como una expresión de caracteres encerrada
     entre paréntesis.

     Consulte las tablas siguientes para obtener más información sobre las
     especificaciones de formato para ficheros de texto ASCII creados
     utilizando estos argumentos.

     VIA <xcControlador> especifica el Controlador de Bases de Datos
     Sustituibles (RDD) que se utiliza para crear la copia. <xcControlador>
     es el nombre del RDD especificado en forma de expresión de caracteres.
      Si <xcControlador> se especifica como valor literal, debe ir entre
     comillas.

     Si la cláusula VIA se omite, COPY TO utiliza el controlador del área de
     trabajo actual. Si se especifica esta cláusula, deberá solicitar el RDD
     apropiado, mediante REQUEST, para enlazarlo con la aplicación.

     Nota: Si se especifica la cláusula DELIMITED WITH en un mandato
     COPY o APPEND, ésta debe ser la última cláusula especificada.

 Descripción

     COPY TO es un mandato de base de datos que copia todo o parte del
     fichero de base de datos actual en un nuevo fichero. Los registros
     contenidos en el fichero de base de datos activo se copian, a no ser
     que estén limitados por un <ámbito>, una cláusula FOR|WHILE o un
     filtro.

     Si DELETED tiene el valor OFF, los registros borrados del fichero
     fuente se copian en <xcFichero>, donde conservan su estado de borrado.
     Si DELETED está activado (ON), no se copian registros borrados.
     Igualmente, si se ha establecido un filtro con el mandato SET FILTER,
     los registros no visibles no se copian.

     Los registros se copian en el orden del índice activo, si hay un índice
     abierto en el área de trabajo actual y SET ORDER no es cero. En caso
     contrario, los registros se copian en su orden natural.

     En un entorno de red, CA-Clipper abre el fichero de base de datos
     destino en modo exclusivo antes de que comience la operación COPY TO.
     Si desea más información, consulte el capítulo "Programación en Red"
     de la Guía de Programación y Utilidades.

     La siguiente tabla muestra las especificaciones de formato para los
     ficheros de texto SDF.

     Especificaciones de Formato para Ficheros de Texto SDF 
     ------------------------------------------------------------------------
     Elemento de Fichero           Formato
     ------------------------------------------------------------------------
     Campos de caracteres          Relleno con espacios en blanco finales
     Campos de fecha               aaaammdd
     Campos lógicos                T o F
     Campos memo                   Se ignoran
     Campos numéricos              Relleno con espacios en blanco iniciales
                                   para ceros
     Separador de campos           Ninguno
     Separador de registros        Retorno de carro/salto de línea
     Marcador de fin de fichero    1A hex o CHR(26)
     ------------------------------------------------------------------------

     La siguiente tabla muestra las especificaciones de formato para
     ficheros de texto ASCII DELIMITED y DELIMITED WITH <xcDelimitador>:

     Especificaciones de Formato para Ficheros de Texto DELIMITED
     ------------------------------------------------------------------------
     Elemento de Fichero           Formato
     ------------------------------------------------------------------------
     Campos de caracteres          Delimitado, con los espacios en blanco
                                   finales truncados
     Campos fecha                  aaaammdd
     Campos lógicos                T o F
     Campos memo                   Se ignoran
     Campos numéricos              Ceros iniciales truncados
     Separador campos              Coma
     Separador registros           Retorno de carro/salto de línea
     Marcador de fin de fichero    1A hex o CHR(26)
     ------------------------------------------------------------------------

     La siguiente tabla muestra las especificaciones de formato para los
     ficheros de texto ASCII DELIMITED WITH BLANK:

     Especificaciones de Formato para Ficheros de Texto DELIMITED WITH BLANK
     ------------------------------------------------------------------------
     Elemento de Fichero           Formato
     ------------------------------------------------------------------------
     Campos de caracteres          No delimitado, con los espacios en blanco
                                   finales truncados
     Campos fecha                  aaaammdd
     Campos lógicos                T o F
     Campos memo                   Se ignoran
     Campos numéricos              Ceros iniciales truncados
     Separador campos              Espacio en blanco
     Separador registros           Retorno de carro/salto de línea
     Marcador de fin de fichero    1A hex o CHR(26)
     ------------------------------------------------------------------------

 Ejemplos

      El ejemplo siguiente muestra cómo se copia en otro fichero de
        base de datos:

        USE Ventas NEW
        COPY TO Temp

      El ejemplo siguiente muestra el diseño de un fichero
        DELIMITED:

        COPY NEXT 1 TO Temp DELIMITED
        TYPE Temp.txt

        Resultado:

        "Carácter",12.00,19890801,T

      Este ejemplo muestra el diseño de un fichero SDF con cuatro
        campos, uno para cada tipo de datos:

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

        Resultado:

        Carácter    12.0019890801T

      Este ejemplo muestra el diseño de un fichero delimitado con
        (DELIMITED WITH) un delimitador diferente:

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

        Resultado:

        'Carácter',12.00,19890801,T

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: APPEND FROM COPY FILE COPY STRUCTURE SET DELETED