TAG( )-Funktion
Gibt entweder den Namen eines Indexes zurück, der Bestandteil einer geöffneten Mehrfachindexdatei (CDX) ist, oder den Namen einer geöffneten Einfachindexdatei (IDX).
TAG([CDXFileName[, nTagNumber[, nWorkArea | cTableAlias]]])
Rückgabewerte
Zeichen
Parameter
CDXFileName
Gibt den Namen der Mehrfachindexdatei (CDX) an, aus der TAG( ) einen Indextag zurückgibt.nTagNumber
Gibt eine Zahl an, die der Reihenfolge entspricht, in der der betreffende Index in der Mehrfachindexdatei angelegt wurde. Wenn beispielsweise nTagNumber gleich 1 ist, gibt TAG( ) den Namen des ersten Indexes zurück, der in der Mehrfachindexdatei erstellt wurde. Wenn beispielsweise für nTagNumber der Wert 2 festgelegt wurde, gibt TAG( ) den Namen des zweiten Indexes zurück, der erstellt wurde usw. TAG( ) gibt eine leere Zeichenfolge zurück, wenn nTagNumber die Anzahl von Indextags überschreitet.Wenn Sie CDXFileName nicht angeben, gibt TAG( ) den Namen eines Indexes, der Bestandteil einer Mehrfachindexdatei ist, bzw. den Namen einer Einfachindexdatei gemäß der nachstehend beschriebenen Reihenfolge zurück.
- Namen von Einfachindexdateien werden entsprechend der Reihenfolge zurückgegeben, in der sie in der INDEX-Klausel von USE oder in SET INDEX stehen.
- Indextags aus der strukturierten Mehrfachindexdatei (falls für die betreffende Tabelle vorhanden) werden zurückgegeben.
- Indextags aus anderen offenen Mehrfachindexdateien werden zurückgegeben, und zwar ebenfalls in der Reihenfolge, in der die Indextags in den Mehrfachindexdateien angelegt wurden, sowie in der Reihenfolge, in der die Mehrfachindexdateien in der INDEX-Klausel für USE oder SET INDEX angegeben wurden.
nWorkAreacTableAlias
Gibt Indextags und Indexdateinamen aus in anderen Arbeitsbereichen geöffneten Dateien zurück. nWorkArea gibt die Nummer des Arbeitsbereichs an, und cTableAlias gibt den Alias der Tabelle an. Standardmäßig werden Indextags und Indexdateinamen von Dateien im aktuellen Arbeitsbereich zurückgegeben.
Hinweise
Indextags sind Indexeinträge in Mehrfachindexdateien (CDX), die mit INDEX angelegt wurden.
Anmerkung Mehrfachindexdateien (CDX) und Einfachindexdateien (IDX) können für eine Tabelle mit der INDEX-Klausel in USE oder mit SET INDEX geöffnet werden. Eine strukturierte Mehrfachindexdatei (CDX) wird automatisch zusammen mit ihrer Tabelle geöffnet.
Beispiel
Im folgenden Beispiel wird die Tabelle customer
in der Datenbank testdata
geöffnet. Mittels FOR ... ENDFOR wird eine Schleife erstellt, in welcher mit CDX( ) der Name jedes Strukturindexes angezeigt wird.
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 .CDX names
ELSE
EXIT && Exit the loop when no more tags are found
ENDIF
ENDFOR
Siehe auch
CDX( ) | INDEX | MDX( ) | NDX( ) | SET INDEX | SYS(14) - Indexausdruck | USE-Befehl