Files
harbour-core/harbour/doc/es/dbsdf.txt
2002-01-22 22:23:33 +00:00

93 lines
3.2 KiB
Plaintext

/*
* $Id$
*/
/*
* Las siguientes partes son derechos adquiridos de sus autores individuales.
* www - http://www.harbour-project.org
*
* Copyright 2001-2002 David G. Holm <dholm@jsd-llc.com>
* Documentación en Inglés de: __dbSDF()
*
* Copyright 2001 Alejandro de Gárate <alex_degarate@hotmail.com>
* Documentación en Español de: __dbSDF()
*
* Vea doc/license.txt por los términos de la licencia.
*
*/
/* $DOC$
* $FUNCNAME$
* __dbSDF()
* $CATEGORY$
* Conversión
* $ONELINER$
* Copia el contenido de una base de datos a un archivo de texto SDF
* ó agrega el contenido de un archivo de texto SDF a una base de
* datos.
* $SYNTAX$
* __dbSDF( <lExporta>, <xcArchivo>, [<aCampos>],
* [<bFor>], [<bWhile>], [<nNext>], [<nRegistro>], <lResto> ) --> NIL
* $ARGUMENTS$
* Si <lExporta> es puesto a .T. copia registros A un archivo SDF.
* Si <lExporta> es .F. agrega registros DESDE un archivo SDF.
*
* <xcArchivo> es el nombre del archivo de texto del cual se va a
* copiar ó al que se va agregar datos.
* Si no es especificada una extensión. ".txt" es usada por defecto.
*
* <aCampos> Un array con los nombres de los campos a los que se limita
* el proceso. Si no es especificado, ó si está vacío, entonces todos
* los campos son procesados.
*
* <bFor> Un bloque de código opcional conteniendo una expresión FOR
* que reducirá el número de registros a ser procesados.
*
* <bWhile> Un bloque de código opcional conteniendo una expresión
* WHILE que reducirá el número de registros a ser procesados.
*
* <nNext> Si está presente, pero <nRegistro> no está presente,
* especifica procesar este número de registros, empezando con el
* registro actual. Un valor de cero significa no procesar registros.
*
* <nRegistro> Si está presente, especifica el único registro a
* procesar un valor de cero significa no procesar ningún registro.
* Predomina sobre <nNext> y <lResto>.
*
* <lResto> Si <lExporta> es .T., y <lResto> es establecido en .T. y
* no hay argumentos <nRegistro>, <nNext> ó <bWhile>, entonces
* procesa todos los registros, desde el actual hasta el último.
* $RETURNS$
* NIL
* $DESCRIPTION$
* __dbSDF() copia todo ó el contenido seleccionado, desde una tabla
* de base de datos a un archivo de texto SDF ó, agrega todo ó el
* contenido seleccionado desde un archivo de texto SDF a una tabla de
* base de datos.
* $EXAMPLES$
* // Copia cuentas delinquentes dentro de un archivo de texto SDF
* USE cuentas NEW
* COPY TO deudas SDF FOR !EMPTY( cuentas->vencidas ) ;
* .AND. DATE() - cuentas->vencidas > 30
*
* // Importa nuevos registros de clientes
* USE clientes NEW
* APPEND FROM clientes SDF
* $TESTS$
*
* $STATUS$
* S
* $COMPLIANCE$
* Es intención que __dbSDF() sea totalmente compatible con la función
* de CA-Clipper del mismo nombre y es la implementación subyacente de
* los comandos: APPEND FROM SDF y COPY TO SDF.
* $PLATFORMS$
* Todas
* $FILES$
*
* $SEEALSO$
* __dbDelim(), APPEND FROM, COPY TO
* $END$
*/