CANDIDATE( )-Funktion
Gibt den Wert Wahr (.T.) zurück, wenn ein Indexname ein potenzieller Indexname ist; andernfalls wird Falsch (.F.) zurückgegeben.
CANDIDATE([nIndexNumber] [, nWorkArea | cTableAlias])
Rückgabewerte
Logisch
Parameter
nIndexNumber
Gibt die Nummer des Indexnamens an, für den CANDIDATE( ) zurückgibt, ob er ein potenzieller Index ist. CANDIDATE( ) gibt in der folgenden Reihenfolge zurück, ob Indizes potenzielle Indizes sind, wenn nIndexNumber von 1 bis zur Gesamtanzahl der Indexnamen in strukturierten und unabhängigen Mehrfachindexdateien erhöht wird:- Zuerst wird der Potenzieller-Index-Status jedes Indexnamens in der strukturierten Mehrfachindexdatei (sofern vorhanden) zurückgegeben. Der Status wird für die Indexnamen in der Reihenfolge zurückgegeben, in der diese in der strukturierten Indexdatei erstellt wurden.
- Als Letztes wird der Potenzieller-Index-Status jedes Indexnamens in allen offenen, unabhängigen Mehrfachindexdateien zurückgegeben. Der Status wird für die Indexnamen in der Reihenfolge zurückgegeben, in der diese in der unabhängigen Mehrfachindexdatei erstellt wurden.
Wird nIndexNumber nicht angegeben, überprüft CANDIDATE( ) den Hauptindexnamen daraufhin, ob dieser ein potenzieller Indexname ist. Ist kein Hauptindexname vorhanden, gibt CANDIDATE( ) den Wert Falsch (.F.) zurück.
nWorkArea
Gibt den Arbeitsbereich des Indexnamens an, der mit nIndexNumber angegeben ist.cTableAlias
Gibt den Arbeitsbereich des Indexnamens an, der mit nIndexNumber angegeben ist.Wenn Sie nWorkArea und cTableAlias nicht angeben, überprüft CANDIDATE( ) den Indexnamen im aktuellen Arbeitsbereich daraufhin, ob dieser ein potenzieller Indexname ist.
Hinweise
Ein Indexname ist dann ein potenzieller Indexname, wenn er keine NULL- oder Duplikatwerte enthält.
Beispiel
Im folgenden Beispiel wird die Tabelle customer in der Datenbank testdata geöffnet. Mittels FOR ... ENDFOR wird eine Schleife erstellt, in welcher der Potenzieller-Index-Status jedes Indexnamens des Strukturindex von customer überprüft wird. Der Name aller Indizes des Strukturindexnamens wird mit seinem Potenzieller-Index-Status angezeigt.
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