<<

Inhaltsverzeichnis

Suchen

>>

 

SORT_FILE

 

 

Funktion

 

 

Syntax:

SORT_FILE(<Eingabedatei>, <Ausgabedatei>, <Auf-/Absteigend>, <Groß-/Kleinschreibung>, <Ab Zeile>, <Position> [,<Trennzeichen> [,<Memory> [,<Makroname>]]])

 

<Eingabedatei>

= <STRING-AUSDRUCK>

<Ausgabedatei>

= <STRING-AUSDRUCK>

<Auf-/Absteigend>

= <NUM-AUSDRUCK>

<Groß-/Kleinschreibung>

= <NUM-AUSDRUCK>

<Ab Zeile>

= <NUM-AUSDRUCK>

<Position>

= <NUM-AUSDRUCK>

<Trennzeichen>

= <STRING-AUSDRUCK>

<Memory>

= <NUM-AUSDRUCK>

<Makroname>

= <MAKRONAME>

 

 

Bedeutung:

SORT_FILE sortiert die sequentielle Datei <Eingabedatei> und speichert die sortierten Datensätze in <Ausgabedatei>.

 

Jede Datenzeile der <Eingabedatei> muss mit einem Zeilenendezeichen (Linefeed) abgeschlossen sein.

 

<Auf-/Absteigend> legt fest, ob auf- oder absteigend sortiert wird. Ist <Auf-/Absteigend> > 0, wird aufsteigend, sonst absteigend sortiert.

 

<Groß-/Kleinschreibung> legt fest, ob bei der Sortierung die Groß-/Kleinschreibung berücksichtigt werden soll. Ist <Groß-/Kleinschreibung> = 0, so wird nicht zwischen Groß- und Kleinschreibung unterschieden, andernfalls schon.

 

<Ab Zeile> legt fest, ab welcher Zeile die Datei sortiert wird. Die Zeilen vor <Ab Zeile> werden nicht sortiert.

 

<Position> legt fest, ab welchem Zeichen in den Datensätzen sortiert wird. Gezählt wird ab 1. <Position> < 1 ist gleichbedeutend mit 1.

 

Ist ein <Trennzeichen> <> ²² angegeben, so wird davon ausgegangen, dass die Einträge in den Zeilen der Datei durch ein Trennzeichen getrennt sind. In diesem Fall bezeichnet <Position> die Nummer eines Teilstrings (SUBSTR$), der sortiert werden soll.

 

<Memory> legt fest, wie groß der programminterne Sortierbereich ist. <Memory> <= 0 ist gleichbedeutend mit 100000. Es werden jeweils <Memory> Zeilen aus der <Eingabedatei> gelesen und sortiert in einer temporären Datei gespeichert. Anschließend wird ein Merge über die temporären Dateien durchgeführt.

 

Ist ein <Makroname> angegeben, so wird der Makro jedesmal aufgerufen, wenn sich der Prozentanteil des Arbeitsfortschritts geändert hat. EBUS_DATA enthält dann den Prozentanteil des Arbeitsfortschritts.

 

Ist kein <Makroname> angegeben, so wird der Prozentanteil des Arbeitsfortschritts in der Meldungszeile angezeigt.

 

SORT_FILE liefert folgende Ergebniswerte:

 

Ergebnis

Bedeutung

0

Kein Fehler

7001

<Eingabedatei> oder <Ausgabedatei> fehlt.

7002

<Eingabedatei> existiert nicht.

7003

Fehler beim Lesen oder Schreiben. ERRORTEXT$ enthält die Fehlermeldung.

 

Parameter:

Eingabedatei

Name der Datei, die sortiert werden soll.

Ausgabedatei

Name der Datei, in die die sortierten Datensätze geschrieben werden.

Auf-/Absteigend

> 0: Es wird aufsteigend sortiert.

sonst: Es wird absteigend sortiert.

Groß-/Kleinschreibung

Legt fest, ob bei der Sortierung die Groß-/Kleinschreibung berücksichtigt werden soll.

Ab Zeile

Legt fest, ab welcher Zeile die Datei sortiert wird.

Position

Legt die Position fest, ab der sortiert wird.

Trennzeichen

Ist ein Trennzeichen <> ²² angegeben, wird ein Teilstring sortiert.

Memory

Legt die Größe des programminternen Sortierbereichs fest.

Makroname

Name des Makros, der aufgerufen wird, wenn sich der Prozentanteil des Arbeitsfortschritts geändert hat.

 

Beispiel:

H% = SORT_FILE(²Testdatei.txt²,²Sort.txt²,1,0,1,3,²;²,0)

 

IF H% <> 0

THEN ERRORMES = ERRORTEXT$ + STR$(H%)

ENDIF

 

Siehe auch:

SORT_ARRAY

SUBSTR$