DESCENDING( )-Funktion

Gibt einen logischen Wert zurück, der anzeigt, ob ein Indexname mit dem DESCENDING-Schlüsselwort erstellt oder das DESCENDING-Schlüsselwort in einen USE-, SET INDEX- oder SET ORDER-Befehl einbezogen wurde.

DESCENDING([CDXFileName[, nIndexNumber [, nWorkArea | cTableAlias]]])

Rückgabewerte

Logisch

Parameter

• CDXFileName
  Gibt den Namen einer Mehrfachindexdatei an. Als Mehrfachindexdatei können Sie die strukturierte Mehrfachindexdatei angeben, die automatisch zusammen mit der Tabelle geöffnet wird, oder eine unabhängige Mehrfachindexdatei.

• nIndexNumber
  Gibt den von DESCENDING( ) überprüften Indexnamen oder die überprüfte Indexdatei an. nIndexNumber ist normalerweise eine Ganzzahl, die bei 1 beginnt und um 1 erhöht wird, um zusätzliche Werte für jeden Indexnamen zurückzugeben.

  Ist nIndexNumber gleich 1, wird ein Wert für die IDX-Hauptindexdatei mit Einfachindex oder der Hauptindexname (sofern vorhanden) zurückgegeben.

  Erhöht sich nIndexNumber, werden Werte für jeden Indexschlüssel des strukturierten Mehrfachindexes (sofern vorhanden) zurückgegeben. Die Werte der Indexschlüssel werden in der Reihenfolge zurückgegeben, in der die Schlüssel im strukturierten Mehrfachindex erstellt wurden.

  Nach Rückgabe der Werte für alle Schlüssel im strukturierten Mehrfachindex werden Werte für jeden Schlüssel in allen geöffneten, unabhängigen Mehrfachindizes zurückgegeben. Die Werte für die Schlüssel werden in der Reihenfolge zurückgegeben, in der die Indexschlüssel in den unabhängigen Mehrfachindizes erstellt wurden.

  Die Rückgabe einer leeren Zeichenfolge erfolgt, wenn nIndexNumber größer als die Gesamtanzahl der offenen IDX-Einfachindexdateien sowie der strukturierten und unabhängigen Mehrfachindexnamen ist.

• nWorkArea cTableAlias
  Gibt Werte für Indexdateien oder Indexnamen zurück, die in einem anderen als dem aktuellen Arbeitsbereich geöffnet sind. nWorkArea gibt die Nummer des Arbeitsbereichs und cTableAlias den Alias der Tabelle an.

  Besitzt keine Tabelle den angegebenen Alias, generiert Visual FoxPro eine Fehlermeldung.

Hinweise

Die folgenden beiden Möglichkeiten stehen zur Verfügung, um Datensätze in einer Tabelle absteigend zu sortieren:

• Geben Sie im INDEX-Befehl das DESCENDING-Schlüsselwort an, um einen Indexnamen in absteigender Reihenfolge in einer Mehrfachindexdatei (CDX) zu erstellen.
• Geben Sie das DESCENDING-Schlüsselwort in einem USE-, SET INDEX- oder SET ORDER-Befehl an, um eine absteigende Reihenfolge für einen Hauptindexnamen oder eine Hauptindexdatei mit Einfachindex (IDX) festzulegen.

DESCENDING( ) kann feststellen, ob ein Indexname in absteigender Reihenfolge erstellt wurde. Der Wert Wahr (.T.) wird zurückgegeben, wenn der angegebene Indexname mit dem Schlüsselwort DESCENDING( ) erstellt wurde.

DESCENDING( ) kann ebenfalls feststellen, ob der Hauptindexname oder die Hauptindexdatei in absteigender Reihenfolge erstellt wurde. Hier wird der Wert Wahr (.T.) zurückgegeben, wenn das DESCENDING-Schlüsselwort in einem USE-, SET INDEX- oder SET ORDER-Befehl für den angegebenen Hauptindexnamen oder eine Einfachindexdatei (IDX) einbezogen wurde.

Wurde keines der optionalen Argumente einbezogen, gibt DESCENDING( ) einen Wert für den Hauptindexnamen oder die Hauptindexdatei zurück. Wurde keines der optionalen Argumente einbezogen und kein Hauptindexname oder kein Hauptindex ist wirksam (weil Sie z. B. die physische Reihenfolge der Datensätze in der Tabelle mit SET ORDER TO wiederhergestellt haben), gibt DESCENDING( ) den Wert Falsch (.F.) zurück.

Beispiel

Im folgenden Beispiel wird die Tabelle customer in der Datenbank testdata geöffnet. FOR ... ENDFOR wird zum Erstellen einer Schleife verwendet, die jeden Indexnamen im strukturierten Index der Tabelle customer daraufhin überprüft, ob es sich um einen absteigenden Index handelt. Der Name jedes strukturierten Indexnamens wird zusammen mit seinem Status der absteigenden Reihenfolge angezeigt.

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
   ? TAG(nCount) + ' Descending? ' && Display tag name
   ?? DESCENDING(nCount)  && Display descending status
   ELSE
      EXIT  && Exit the loop when no more tags are found
   ENDIF
ENDFOR

Siehe auch

INDEX | SET INDEX | SET ORDER | USE