/*
 * $Id: rdd.txt 9312 2008-09-05 00:08:34Z vszakats $
 */

/*
 * Las siguientes partes son derechos adquiridos de sus autores individuales.
 * www - http://www.harbour-project.org
 *
 * Copyright 2003 Alejandro de Grate <alex_degarate@hotmail.com>
 * Documentacin en Espaol de: 
 *    DB*(), ORD*(), RDD*()
 *
 * Copyright 1999 Luiz Rafael Culik <culik@sl.conex.net>
 * Documentacin en Ingls de: 
 *    DB*(), ORD*(), RDD*()
 *
 * Vea doc/license.txt por los trminos de la licencia.
 *
 */

/*  $DOC$
 *  $FUNCNAME$
 *      RDDLIST()
 *  $CATEGORY$
 *      Base de Datos
 *  $ONELINER$
 *      Retorna un array con los Manejadores de Bases de Datos disponibles
 *  $SYNTAX$
 *      RDDLIST([<nTipoRDD>]) --> aRDDLista
 *  $ARGUMENTS$
 *      <nTipoRDD>  es un entero que representa el tipo de RDD que Ud. desea
 *                  listar.  Las constantes RDT_FULL y RDT_TRANSFER 
 *                  representan los dos tipos de RDDs actualmente disponibles
 *
 *      Resumen de Tipo de RDDs 
 *      
 *      Constante      Valor       Significado
 *      
 *      RDT_FULL         1         Implementacin Completa de RDD
 *      RDT_TRANSFER     2         Solamente driver Importar/Exportar
 *      
 *
 *      RDT_FULL identifica a los RDDs que tienen todas las capacidades que
 *      se asocian con un RDD.
 *
 *      RDT_TRANSFER identifica a RDDs de capcidad limitada. Estos solamente
 *      pueden transferir registros entre archivos. Ud. no puede usar estos 
 *      limitados drivers para abrir un archivo en un rea de trabajo.
 *      Los manejadores SDF y DELIM son ejemplos de este tipo de RDD.
 *      Ellos solamente son usados en la implementacin de APPEND FROM y 
 *      COPY TO con archivos SDF  DELIMITED.
 *  $RETURNS$
 *      RDDLIST() retorna un array unidimensional de los nombres de RDD 
 *      registrados con la aplicacin como <nTipoRDD>.
 *  $DESCRIPTION$
 *      RDDLIST() es una funcin que devuelve una array de una dimensin
 *      que contiene los nombres de todos los RDD disponibles.
 *
 *      Si Ud. no especifica <nTipoRDD>, sern devueltos todos los RDD 
 *      disponibles sin importar el tipo.
 *  $EXAMPLES$
 *      En este ejemplo RDDLIST() retorna un array conteniendo las cadenas 
 *      de caracteres: "DBF", "SDF", "DELIM", "DBFCDX", and "DBFNTX":
 *
 *      REQUEST DBFCDX
 *      .
 *      . < sentencias >
 *      .
 *      aRDDs := RDDLIST()   // Retorna 
 *                           // {"DBF", SDF", "DELIM", "DBFCDX", "DBFNTX" }
 *
 *
 *      En este ejemplo RDDLIST() retorna un array conteniendo las
 *      cadenas de caracteres: "SDF" and "DELIM":
 *
 *      #include "rddsys.ch"
 *      .
 *      . < sentencias >
 *      .
 *      aImpExp := RDDLIST( RDT_TRANSFER )
 *
 *  $TESTS$
 *
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *
 *  $SEEALSO$
 *      RDDNAME()
 *  $INCLUDE$
 *      El archivo de cabecera es rddsys.ch
 *  $END$
 */

/*  $DOC$
 *  $FUNCNAME$
 *      RDDNAME()
 *  $CATEGORY$
 *      Base de Datos
 *  $ONELINER$
 *      Retorna el nombre del RDD actualmente activo
 *  $SYNTAX$
 *      RDDNAME() --> cNombreRDD
 *  $ARGUMENTS$
 *      Ninguno
 *  $RETURNS$
 *      Retorna una cadena de caracteres, el nombre registrado del RDD activo
 *      en el rea de trabajo actual  en el rea especificada.
 *  $DESCRIPTION$
 *      RDDNAME() es una funcin que devuelve una cadena de caracteres con el
 *      nombre registrado del RDD activo en el rea de trabajo actual  en el 
 *      rea especificada.
 *
 *      Ud. puede especificar un rea de trabajo distinta de la actual usando
 *      un alias con la funcin.
 *  $EXAMPLES$
 *      USE Customer VIA "DBFNTX" NEW
 *      USE Sales    VIA "DBFCDX" NEW
 *
 *      ? RDDNAME()                   // Retorna: DBFCDX (area actual)
 *      ? Customer->( RDDNAME() )     // Retorna: DBFNTX (area especificada)
 *      ? Sales->( RDDNAME() )        // Retorna: DBFCDX (area especificada)
 *  $TESTS$
 *
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *
 *  $SEEALSO$
 *      RDDLIST()
 *  $INCLUDE$
 *
 *  $END$
 */

/*  $DOC$
 *  $FUNCNAME$
 *      RDDSETDEFAULT()
 *  $CATEGORY$
 *      Base de Datos
 *  $ONELINER$
 *      Establece  retorna el RDD por defecto para la aplicacin.
 *  $SYNTAX$
 *      RDDSETDEFAULT( [<cNewDefaultRDD>] ) --> cPreviousDefaultRDD
 *
 *  $ARGUMENTS$
 *      <cNewDefaultRDD> es una cadena de caracteres, el nombre del RDD que
 *                       va a ser hecho el nuevo RDD por defecto para la 
 *                       aplicacin.
 *  $RETURNS$
 *      RDDSETDEFAULT() retorna una cadena de caracteres conteniendo el 
 *      nombre del manejador por defecto anterior <cPreviousDefaultRDD>. 
 *  $DESCRIPTION$
 *      RDDSETDEFAULT() es una funcin que devuelve el nombre del manejador
 *      (driver) por defecto anterior <cPreviousDefaultRDD> y opcionalmente 
 *      establece el manejador actual, especificado por <cNewDefaultRDD>.
 *
 *      Si <cNewDefaultRDD> no es especificado, el nombre del manejador por 
 *      defecto actual es devuelto y ste contina siendo el manejador por 
 *      defecto. El manejador por defecto es el driver que Harbour usa si Ud.
 *      no especifica explcitamente un RDD con la clusula VIA en el comando
 *      USE.
 *
 *      Esta funcin reemplaza a la funcin DBSETDRIVER() 
 *  $EXAMPLES$
 *      // Si el manejador por defecto no es DBFNTX, ponerlo por defecto
 *
 *      IF ( RDDSETDEFAULT() != "DBFNTX" )
 *           cOldRdd := RDDSETDEFAULT( "DBFNTX" )
 *      ENDIF
 *  $TESTS$
 *
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *
 *  $SEEALSO$
 *      DBSETDRIVER()
 *  $INCLUDE$
 *
 *  $END$
 */


/*  $DOC$
 *  $FUNCNAME$
 *      __RDDSETDEFAULT()
 *  $CATEGORY$
 *      Base de Datos
 *  $ONELINER$
 *      Establece  retorna el RDD por defecto para la aplicacin.
 *  $SYNTAX$
 *      __RDDSETDEFAULT( [<cNewDefaultRDD>] ) --> cPreviousDefaultRDD
 *  $ARGUMENTS$
 *      <cNewDefaultRDD> es una cadena de caracteres, el nombre del RDD que
 *                       va a ser hecho el nuevo RDD por defecto para la 
 *                       aplicacin.
 *  $RETURNS$
 *      __RDDSETDEFAULT() retorna una cadena de caracteres conteniendo el 
 *      nombre del manejador por defecto anterior <cPreviousDefaultRDD>. 
 *  $DESCRIPTION$
 *      __RDDSETDEFAULT() es una funcin que devuelve el nombre del manejador
 *      (driver) por defecto anterior <cPreviousDefaultRDD> y opcionalmente 
 *      establece el manejador actual, especificado por <cNewDefaultRDD>.
 *
 *      Si <cNewDefaultRDD> no es especificado, el nombre del manejador por 
 *      defecto actual es devuelto y ste contina siendo el manejador por 
 *      defecto. El manejador por defecto es el driver que Harbour usa si Ud.
 *      no especifica explcitamente un RDD con la clusula VIA en el comando
 *      USE.
 *      Esta es una funcin de bajo nivel y debe usarse RDDSETDEFAULT() en su
 *      lugar.
 *      Esta funcin reemplaza a la funcin DBSETDRIVER() 
 *  $EXAMPLES$
 *      // Si el manejador por defecto no es DBFNTX, ponerlo por defecto
 *
 *      IF ( __RDDSETDEFAULT() != "DBFNTX" )
 *           cOldRdd := __RDDSETDEFAULT( "DBFNTX" )
 *      ENDIF
 *  $TESTS$
 *
 *  $STATUS$
 *      R
 *  $COMPLIANCE$
 *
 *  $SEEALSO$
 *      DBSETDRIVER()
 *  $INCLUDE$
 *
 *  $END$
 */ 



