CDX( ) (Función)

Artículo
04/11/2008

Devuelve el nombre del archivo de índice compuesto (.cdx) abierto que tiene el número de posición de índice especificado.

CDX(nIndexNumber [, nWorkArea | cTableAlias])

Valores devueltos

Character

Parámetros

nIndexNumber
Lo siguiente se aplica a una tabla con un índice compuesto estructural y uno o más índices compuestos:

nIndexNumber	Descripción
1	Devuelve el nombre del archivo de índice estructural (que es siempre el mismo que el nombre de la tabla).
2	Devolverá el nombre del primer archivo de índice compuesto especificado en la cláusula INDEX del comando USE, o en SET INDEX.
3	Devolverá el nombre del segundo archivo de índice compuesto, si lo hay, y así sucesivamente.
Mayor que el número de archivos .cdx abiertos.	Devolverá la cadena vacía.

Lo siguiente se aplica a una tabla sin un índice compuesto estructural y uno o más índices compuestos:

nIndexNumber	Descripción
1	Devolverá el nombre del primer archivo de índice compuesto especificado en la cláusula INDEX del comando USE, o en SET INDEX.
2	Devolverá el nombre del segundo archivo de índice compuesto, si lo hay, y así sucesivamente.
Mayor que el número de archivos .cdx abiertos.	Devolverá la cadena vacía.

nWorkArea
Especifica el número del área de trabajo de una tabla para la que desea devolver mediante CDX( ) los nombres de archivo de índice compuesto que están abiertos.
cTableAlias
Especifica el alias de la tabla para la que desea devolver mediante CDX( ) los nombres de archivo de índice compuesto que están abiertos.

Si omite nWorkArea y cTableAlias, se devolverán los nombres de los archivos de índice compuesto para la tabla del área de trabajo seleccionada actualmente.

Observaciones

La función CDX( ) es idéntica a la función MDX( ).

Un índice .cdx (compuesto) consiste en un archivo físico que contiene muchas etiquetas de índice. Cada etiqueta de índice es una referencia de orden de índice para la tabla asociada.

Hay dos tipos de archivos .cdx: índice compuesto estándar e índice estructural. Un índice compuesto estándar (.cdx) puede tener un nombre distinto de su tabla asociada y puede residir en otro directorio distinto que su tabla. Una tabla puede tener múltiples archivos de índice compuesto. Un índice compuesto se abre con la cláusula INDEX del comando USE o con SET INDEX.

Un archivo .cdx estructural debe tener el mismo nombre que su tabla asociada y debe residir en el mismo directorio. Una tabla sólo puede tener un archivo de índice estructural. Los archivos .cdx estructurales se abren y se actualizan automáticamente cuando se abre la tabla asociada con USE.

Cualquier archivo .idx (índice compatible con Microsoft FoxBASE+ y FoxPro 1.0) especificado en USE o en SET INDEX se pasa por alto en la función CDX( ).

Utilice TAG( ) para devolver nombres de etiquetas individuales contenidas en un archivo .cdx y utilice NDX( ) para devolver el nombre de los archivos .idx abiertos.

Cuando SET FULLPATH está establecido en ON, CDX( ) devuelve la ruta de acceso y el nombre del .cdx. Cuando SET FULLPATH está establecido en OFF, CDX( ) devuelve la unidad y el nombre del archivo .cdx.

Ejemplo

El ejemplo siguiente abre la tabla customer de la base de datos testdata. FOR ... ENDFOR se utiliza para crear un bucle en el que se muestra el nombre de cada índice estructural.

CLOSE DATABASES
OPEN DATABASE (HOME(2) + 'data\testdata')
USE customer     && Open customer table

CLEAR
FOR nCount = 1 TO 254
   IF !EMPTY(TAG(nCount))  && Checks for tags in the index
   ? CDX(nCount)     && Display structural index names
   ELSE
      EXIT  && Exit the loop when no more tags are found
   ENDIF
ENDFOR

Vea también

Share via