<<

Inhaltsverzeichnis

Suchen

>>

 

GET_FIRST_RECORD

 

 

Funktion

 

 

Syntax:

GET_FIRST_RECORD(<Indexdateiname>[, <Suchen nach>, <Unterscheidung Groß/Klein>, <Trennzeichen>, <AND oder OR>,<Bereiche>])

 

<Indexdateiname>

= <INDEXDATEI>

<Suchen nach>

= <STRING-AUSDRUCK>

<Unterscheidung Groß/Klein>

= <NUM-AUSDRUCK>

<Trennzeichen>

= <STRING-AUSDRUCK>

<AND oder OR>

= <NUM-AUSDRUCK>

<Bereiche>

= <STRING-AUSDRUCK>

 

Bedeutung:

Liest den ersten physikalischen Datensatz einer Ebus-Indexdatei.

 

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

 

Ist <Unterscheidung Groß/Klein> <> 0, so wird bei der Suche zwischen Groß- und Kleinbuchstaben unterschieden, andernfalls nicht.

 

Ist <Trennzeichen> <> "", so wird davon ausgegangen, das in <Suchen nach> mehrere Zeichenfolgen enthalten sind, nach denen gesucht werden soll. Das 1. Zeichen von <Trennzeichen> legt das Zeichen fest, das diese Zeichenfolgen trennt. <AND oder OR> legt fest, ob alle Zeichenfolgen vorhanden sein müssen oder nur eine. Ist <AND oder OR> = 1, so müssen alle Zeichenfolgen vorhanden sein (AND - Verknüpfung). Ist <AND oder OR> <> 1, so muss nur eine der Zeichenfolgen vorhanden sein (OR - Verknüpfung).

 

Ist <Trennzeichen> = "", so hat <AND oder OR> keine Bedeutung.

 

<Bereiche> legt fest, in welchen Bereichen des Datensatzes nach <Suchen nach> gesucht werden soll. Ein Bereich wird durch

<Anfangsposition>,<Endeposition>

festgelegt. Die Positionen beziehen sich auf die Position im Datensatz, gezählt wird ab 1. Mit Hilfe der Funktionen GET_FIELDPOS und GET_FIELDLENGTH können die Position und Länge der Indexdateifelder im Datensatz berechnet werden. Mehrere Bereiche sind durch Strichpunkte zu trennen.

 

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.

 

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_FIRST_RECORD liefert folgende Ergebniswerte:

 

Ergebnis

Bedeutung

 1

Kein Fehler

-1

Die Indexdatei enthält keine Datensätze

-2

<Indexdateiname> ist eine JDBC-Indexdatei.

-3

Die Indexdatei ist nicht offen.

 

Parameter:

Indexdateiname

Name der Indexdatei

 

Suchen nach

Suchstring

 

Unterscheidung Groß/Klein

<> 0: Es wird zwischen Groß- und Kleinschreibung unterschieden.

0: Keine Unterscheidung zwischen Groß- und Kleinschreibung

 

Trennzeichen

Trennzeichen für mehrere Suchstrings

 

AND oder OR

Verknüpfungsart bei mehreren Suchstrings:

1 = AND

sonst = OR

 

Bereiche

Legt fest, in welchen Bereichen des Datensatzes nach <Suchen nach> gesucht werden soll.

 

Beispiel:

H% = GET_FIRST_RECORD(KUNDEN)

WHILE H% = 1

DO H% = GET_NEXT_RECORD(KUNDEN)

...

ENDDO

 

/* Suchen Huber in KUNDEN.NAME$ und KUNDEN.VORNAME$

POS1% = GET_FIELDPOS("KUNDEN","NAME$")

L1%   = GET_FIELDLENGTH("KUNDEN","NAME$")

POS2% = GET_FIELDPOS("KUNDEN","VORNAME$")

L2%   = GET_FIELDLENGTH("KUNDEN","VORNAME$")

BEREICHE$ = STRN$(POS1%) + "," + STRN$(POS1% + L1% - 1) + ";"

            STRN$(POS2%) + "," + STRN$(POS2% + L2% - 1)

H% = GET_FIRST_RECORD(KUNDEN,"Huber",0,"",0,BEREICHE$)

WHILE H% = 1

DO H% = GET_NEXT_RECORD(KUNDEN)

...

ENDDO

 

Siehe auch:

GET_NEXT_RECORD

START

READ-NEXT

SEARCH