<<

Inhaltsverzeichnis

Suchen

>>

 

READ_PREVIOUS_MULTI

 

 

Funktion

 

 

Syntax:

READ_PREVIOUS_MULTI(<Indexdateiname>, <Schlüsselnummer>, <Tabelle>, <Anzahl>)

 

<Indexdateiname>

= <INDEXDATEI>

<Schlüsselnummer>

= <NUM-AUSDRUCK>

<Tabelle>

= <STRING-VARIABLE>

<Anzahl>

= <NUM-AUSDRUCK>

 

Bedeutung:

READ_PREVIOUS_MULTI liest mehrere Datensätze aus einer Indexdatei und speichert sie im Array <Tabelle>. Die Anzahl der zu lesenden Datensätze wird durch <Anzahl> festgelegt.

 

Das Lesen von mehreren Datensätzen auf einmal bringt insbesondere beim Ebus-Server einen signifikanten Geschwindigkeitsvorteil.

 

<Schlüsselnummer> legt den Schlüssel fest, über den die Datensätze gelesen werden sollen. 0 bezeichnet den Primärkey, 1,..,n den entsprechenden Sekundärkey.

 

<Tabelle> muss ein eindimensionales alphanumerisches Array sein, das mindestens <Anzahl> Elemente enthält.

 

<Indexdateiname> muss eine Ebus-Indexdatei sein.

 

READ_PREVIOUS_MULTI führt mehrere Anweisungen READ-PREVIOUS bzw. READS-PREVIOUS hintereinander aus. Dabei wird die <Tabelle> beginnend ab Element Nr. 1 mit RECORD$(<Indexdateiname>) gefüllt. Werden weniger als <Anzahl> Datensätze gefunden, so werden nur die gefundenen Datensätze in <Tabelle> eingetragen. READ_PREVIOUS_MULTI liefert als Ergebnis die Anzahl der gelesenen Datensätze.

 

READ_PREVIOUS_MULTI ist nur dann erfolgreich, wenn der Dateipointer richtig gesetzt ist, d.h. dass vorher eine gültige START-, READ-, READ-NEXT oder READ-PREVIOUS-Anweisung mit demselben Schlüssel ausgeführt wurde.

 

READ_PREVIOUS_MULTI liefert folgende Ergebniswerte:

 

Ergebnis

Bedeutung

>= 0

Anzahl der gelesenen Datensätze

-1

Die Indexdatei ist nicht offen oder keine Ebus-Indexdatei.

-2

<Anzahl> ist < 1.

-3

ungültige Schlüsselnummer

 

Parameter:

Indexdateiname

Name der Indexdatei

Schlüsselnummer

0 = Primärkey

> 0 = Sekundärkey

Tabelle

Eindimensionales alphanumerisches Array mit mindestens <Anzahl> Elementen.

Anzahl

Anzahl der zu lesenden Datensätze.

 

 

Beispiel:

DIM T$(10)

 

KUNDEN.NR = 9999999

START KUNDEN ON ERROR END

ANZAHL% = READ_PREVIOUS_MULTI(KUNDEN,0,T$,10)

IF ANZAHL% < 1
THEN ... Fehler ..
ELSE FOR I% = 1 TO ANZAHL%

         RECORD(KUNDEN) = T$(I%)
         ...
     ENDLOOP
ENDIF

 

Siehe auch:

READ_NEXT_MULTI

READ-PREVIOUS