CANDIDATE( ) (Función)
Devuelve verdadero (.T.) si una etiqueta de índice es una etiqueta de índice candidato; de lo contrario, devuelve falso (.F.).
CANDIDATE([nIndexNumber] [, nWorkArea | cTableAlias])
Valores devueltos
Logical
Parámetros
nIndexNumber
Especifica el número de la etiqueta de índice para la que CANDIDATE( ) devuelve el estado de candidato. CANDIDATE( ) devuelve el estado de candidato en el orden siguiente a medida que nIndexNumber aumenta en 1 el número total de etiquetas de índice estructural compuesto y compuesto independiente:- En primer lugar se devuelve el estado candidato de cada etiqueta del índice estructural compuesto (si hay alguno). Se devuelve el estado candidato de las etiquetas en el orden en que se han creado en el índice estructural.
- En último lugar se devuelve el estado candidato de cada etiqueta de cualquier índice estructural compuesto independiente que esté abierto. Se devuelve el estado candidato de las etiquetas en el orden en que se han creado en los índices compuestos independientes.
Si omite nIndexNumber, CANDIDATE( ) comprueba si la etiqueta de índice principal de control es una etiqueta de índice candidato. Si no hay una etiqueta de índice principal de control, CANDIDATE( ) devuelve falso (.F.).
nWorkArea
Especifica el área de trabajo de la etiqueta de índice especificada con nIndexNumber.cTableAlias
Especifica el área de trabajo de la etiqueta de índice especificada con nIndexNumber.Si omite nWorkArea y cTableAlias, CANDIDATE( ) comprueba si la etiqueta de índice del área de trabajo seleccionada actualmente es una etiqueta de índice candidato.
Observaciones
Una etiqueta de índice candidato es una etiqueta de índice que puede convertirse en la etiqueta de índice principal porque no contiene valores nulos o duplicados.
Ejemplo
El ejemplo siguiente abre la tabla customer
de la base de datos testdata
. FOR ... ENDFOR para crear un bucle en el cual se comprueba el estado de candidato de cada etiqueta de índice del índice estructural customer
. El nombre de cada etiqueta de índice estructural se muestra con su estado de candidato.
CLOSE DATABASES
OPEN DATABASE (HOME(2) + 'data\testdata')
USE customer && Open customer table
FOR nCount = 1 TO 254
IF !EMPTY(TAG(nCount)) && Checks for tags in the index
? TAG(nCount) && Display tag name
? CANDIDATE(nCount) && Display candidate status
ELSE
EXIT && Exit the loop when no more tags are found
ENDIF
ENDFOR