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 á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.

 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 DPXBASE.CH.