Freigeben über

SYS(2021) - Gefilterter Indexausdruck

  • Artikel

Gibt den Filterausdruck für eine geöffnete Indexdatei (IDX) mit einem Eintrag oder die Filterausdrücke der Indextags in zusammengesetzten Indexdateien (CDX) zurück.

SYS(2021, nIndexNumber [, nWorkArea | cTableAlias])

Rückgabewerte

Zeichen

Parameter

  • nIndexNumber
    Der numerische Ausdruck nIndexNumber gibt an, welcher Filterausdruck aus den geöffneten Indexdateien zurückgegeben werden soll. SYS(2021) gibt die Filterausdrücke der geöffneten Indexdateien in der folgenden Reihenfolge zurück, wenn nIndexNumber von 1 bis zur Gesamtanzahl der geöffneten IDX-Dateien mit einem Eintrag der zusammengesetzten Strukturindextags und der unabhängigen Indextags hochgezählt wird:

    1. Zuerst werden die Filterausdrücke der IDX-Dateien mit einem Eintrag (sofern geöffnet) zurückgegeben. Die Reihenfolge, in der die IDX-Dateien mit einem Eintrag in USE oder SET INDEX eingefügt werden, bestimmt die Reihenfolge, in der die Filterausdrücke zurückgegeben werden.
    2. Als Nächstes werden die Filterausdrücke für die einzelnen Indextags innerhalb der strukturierten CDX-Indexdatei (wenn vorhanden) zurückgegeben. Die Filterausdrücke der Schlüssel werden in der Reihenfolge zurückgegeben, in der die Schlüssel im strukturierten Index erstellt wurden.
    3. Zuletzt werden die Filterausdrücke der einzelnen Indextags aus allen geöffneten unabhängigen CDX-Dateien zurückgegeben. Die Filterausdrücke der Indextags werden in der Reihenfolge zurückgegeben, in der sie in den unabhängigen zusammengesetzten Indizes erstellt wurden.

    Es wird eine leere Zeichenfolge zurückgegeben, wenn nIndexNumber größer als die Gesamtanzahl der geöffneten IDX-Dateien mit einem Eintrag sowie der strukturierten und unabhängigen CDX-Dateischlüssel ist.

  • nWorkArea
    Gibt die Nummer des Arbeitsbereichs für eine in einem anderen Arbeitsbereich geöffnete Tabelle an.

  • cTableAlias
    Gibt einen Tabellenalias für eine Tabelle an, die in einem anderen Arbeitsbereich geöffnet wurde. Wenn sich dort keine Tabelle mit dem von Ihnen angegebenen Alias befindet, zeigt Visual FoxPro eine Fehlermeldung an.

Hinweise

Sie können in Visual FoxPro gefilterte Indizes erstellen. Wenn Sie die optionale FOR-Klausel in INDEX einfügen, wirkt die Indexdatei als Filter für die Tabelle. Nur die Datensätze, die den Filterausdruck lExpression in der FOR-Klausel erfüllen, sind für Anzeige und Zugriff verfügbar. Indizes werden in der Indexdatei nur für die Datensätze erstellt, die dem Filterausdruck entsprechen.

Es wird eine leere Zeichenfolge zurückgegeben, wenn ein Index oder Indextag ohne FOR-Klausel erstellt wird.

USE und SET INDEX unterstützen eine Indexdatei-Namenliste, über die Sie Indexdateien für eine Tabelle öffnen können. In der Indexdatei-Namenliste können alle Kombinationen aus Namen von IDX-Dateien mit einem Eintrag, strukturierten CDX-Indexdateien und unabhängigen CDX-Dateien enthalten sein.

SYS(2021) gibt die Filterausdrücke der im aktuellen Arbeitsbereich geöffneten Indexdateien zurück, wenn Sie keinen bestimmten Arbeitsbereich oder Alias angeben.

Siehe auch

CDX( ) | KEY( ) | INDEX | MDX( ) | NDX( ) | REINDEX | SET INDEX | SET ORDER | SYS( ) - Funktionen - Überblick | TAG( )