READ_NEXT_MULTI
|
Syntax: |
READ_NEXT_MULTI(<Indexdateiname>,
<Schlüsselnummer>, <Tabelle>, <Anzahl>)
|
||||||||||
|
Bedeutung: |
READ_NEXT_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_NEXT_MULTI
führt mehrere Anweisungen READ-NEXT bzw. READS-NEXT 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_NEXT_MULTI
liefert als Ergebnis die Anzahl der gelesenen Datensätze. READ_NEXT_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_NEXT_MULTI
liefert folgende Ergebniswerte:
|
||||||||||
|
Parameter: |
|
||||||||||
|
Beispiel: |
DIM T$(10) INITIALIZE
KUNDEN START KUNDEN ON ERROR END ANZAHL% = READ_NEXT_MULTI(KUNDEN,0,T$,10) IF ANZAHL% < 1 RECORD(KUNDEN)
= T$(I%) |
||||||||||
|
Siehe
auch: |
|