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.

• nWorkArea cTableAlias
  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