DBCREATEINDEX()
 Crea un fichero índice
------------------------------------------------------------------------------
 Sintaxis

     DBCREATEINDEX(<cNombreIndice>, <cExprClave>,
        [<bExprClave>], [<lUnico>]) --> NIL

 Argumentos

     <cNombreIndice> es un valor de caracteres, que especifica el nombre
     del fichero de índice que va a crearse.

     <cExprClave> es un valor de caracteres, que representa la expresión
     clave del índice en forma de texto.

     <bExprClave> es un bloque de código, que representa la expresión
     clave del índice en forma ejecutable.

     <lUnico> es un valor lógico opcional, que especifica si debe
     crearse un índice único. Si se omite <lUnico>, se utiliza el valor de
     SET UNIQUE global actual.

 Devuelve

     DBCREATEINDEX() devuelve siempre NIL.

 Descripción

     DBCREATEINDEX() crea un índice para el fichero de base de datos (.dbf)
     asociado con el área de trabajo actual. Si el área de trabajo tiene
     índices activos, se cierran. Cuando se crea el nuevo índice, se
     convierte en el de control del área de trabajo y el puntero se sitúa en
     el primer registro lógico.

     DBCREATEINDEX() realiza la misma función que un mandato INDEX estándar.
     Si desea más información, consulte el mandato INDEX.

 Notas

     ■ Efectos laterales: DBCREATEINDEX() garantiza la creación de un
        índice que, cuando se activa, impone el orden lógico especificado en
        la base de datos. Si la expresión clave se basa en información
        externa al fichero de base de datos o al área de trabajo, el efecto
        es impredecible. Si la expresión clave cambia el estado del área de
        trabajo (por ejemplo, desplazando el contenido de un registro a un
        registro diferente o cambiando el contenido del mismo), el efecto es
        impredecible.

     ■ Contexto de evaluación: Cuando se evalúa la expresión clave,
        el área de trabajo asociada se selecciona automáticamente como el
        área de trabajo actual antes de la evaluación. Posteriormente se
        restablece el área de trabajo seleccionada previamente.

     ■ Entorno de red: DBCREATEINDEX() crea el nuevo índice para uso
        exclusivo del proceso actual.

     ■ Expresión ilegal: Si <cExprClave> se evalúa como una expresión
        ilegal, el resultado de evaluar el bloque de código siempre será el
        valor fin de fichero (EOF).

 Ejemplos

      Este ejemplo crea un fichero índice, INombre, cuya clave es el
        campo Nombre:

        USE Empleados NEW
        DBCREATEINDEX( "INombre", "Nombre", { || Nombre })

 Ficheros   La biblioteca asociada es CLIPPER.LIB.
 To download this example - click here.

See Also: DBCLEARIND() DBREINDEX() DBSETINDEX() DBSETORDER()