READ_PREVIOUS_MULTI
|
Syntax: |
READ_PREVIOUS_MULTI(<Indexdateiname>,
<Schlüsselnummer>, <Tabelle>, <Anzahl>)
|
||||||||||
|
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:
|
||||||||||
|
Parameter: |
|
||||||||||
|
Beispiel: |
DIM T$(10) KUNDEN.NR = 9999999 START KUNDEN ON
ERROR END ANZAHL% = READ_PREVIOUS_MULTI(KUNDEN,0,T$,10) IF ANZAHL% < 1 RECORD(KUNDEN)
= T$(I%) |
||||||||||
|
Siehe
auch: |
|