<<

Inhaltsverzeichnis

Suchen

>>

 

GET_NEXT_RECORD

 

 

Funktion

 

 

Syntax:

GET_NEXT_RECORD(<Indexdateiname>)

 

<Indexdateiname> = <INDEXDATEI>

 

Bedeutung:

Liest den nächsten physikalischen Datensatz einer Ebus-Indexdatei.

 

Wurde bei GET_FIRST_RECORD <Suchen nach> angegeben, so werden mit GET_NEXT_RECORD nur diejenigen Datensätze geliefert, die <Suchen nach> enthalten.

 

GET_FIRST_RECORD und GET_NEXT_RECORD lesen die Datensätze einer Indexdatei nicht über einen Schlüssel, sondern in der Reihenfolge, wie sie physikalisch in der Datendatei gespeichert sind.

 

Vor dem ersten Aufruf von GET_NEXT_RECORD muss GET_FIRST_RECORD aufgerufen werden. Damit wird der Dateipointer auf den Dateianfang gesetzt und die Bedingungen für <Suchen nach> werden gesetzt. Mit GET_NEXT_RECORD wird jeweils der nächste physikalisch gespeicherte Datensatz gelesen.

 

Die Funktionen GET_FIRST_RECORD und GET_NEXT_RECORD können dazu verwendet werden, alle Datensätze einer Indexdatei mit vielen Datensätzen schneller zu lesen als mit START und READ-NEXT. GET_FIRST_RECORD und GET_NEXT_RECORD sind im Multiuserbetrieb bis zu viermal so schnell wie START und READ-NEXT.

 

Achtung: ON INDEXERROR MACRO und ON READ(<INDEXDATEI>) MACRO werden bei dieser Funktion nicht ausgeführt.

 

GET_NEXT_RECORD liefert folgende Ergebniswerte:

 

Ergebnis

Bedeutung

 1

Kein Fehler

-1

Kein weiterer Datensatz vorhanden

-2

<Indexdateiname> ist eine JDBC-Indexdatei.

-3

Die Indexdatei ist nicht offen.

-4

GET_FIRST_RECORD wurde nicht ausgeführt.

 

Parameter:

Indexdateiname

Name der Indexdatei

 

Beispiel:

H% = GET_FIRST_RECORD(KUNDEN)

WHILE H% = 1

DO H% = GET_NEXT_RECORD(KUNDEN)

...

ENDDO

 

Siehe auch:

GET_FIRST_RECORD

START

READ-NEXT