f$PGSort
f$PGSort
Sortieren einer einfach indizierten Parametergruppe nach einem oder mehreren Parametern. Die Sortierung kann wahlweise auf- oder absteigend erfolgen. Die Begrenzung der Anzahl zu sortierender Datensätze erfolgt über den Inhalt der 1. Sortierspalte. Wird in dieser Spalte ein Parameter mit dem Zustand UNDEF bzw. LEER (gefunden, wird dieser Index als Endekriterium der Sortierung verwendet.
Bitte beachten: Die Parametergruppe darf keine indizierten Parameter enthalten.
Bitte beachten: Der Name der Parametergruppe wird in der Regel als Zeichenketten-Konstante übergeben, also in Anführungszeichen eingeschlossen.
Syntax: | Status = f$PGSort( PGName, Spaltenliste [,Endekriterium] ) | |||
| Argument | Typ | Bedeutung | |
| PGName | Zeichenkette | Name der Parametergruppe, die sortiert werden soll | |
| Spaltenliste | Zeichenkette | Liste von Parametern der Parametergruppe, nach welchen sortiert werden soll. Ist der Spaltenname mit – am Ende des Namens versehen, so wird diese Spalte absteigend sortiert. Die Parameternamen werden mit , getrennt. Leerzeichen zwischen den Namen sind nicht erlaubt. | |
| Endekriterium | Ganzzahl | Kennzeichnung, ob Parameter im Zustand LEER ebenfalls als Begrenzung der Sortierung verwendet werden: | |
Ergebnis: | Ganzzahl | 0 : alles ok -1 : Die Parametergruppe existiert nicht -2 : Die Parametergruppe ist nicht indiziert -3 : Parameter nicht gefunden | ||
Beispiel: | Status = f$PGSort ('Anschriften','LKZ,PLZ-,Rufname') In diesem Beispiel wird die Liste der Anschriften erst nach dem Länderkennzeichen sortiert. Alle Anschriften desselben Lands werden absteigend nach der Postleitzahl sortiert. Innerhalb der Postleitzahl werden die Anschriften nach dem Namen aufsteigend sortiert. | |||