GET_FIRST_RECORD
|
Syntax: |
GET_FIRST_RECORD(<Indexdateiname>[, <Suchen nach>, <Unterscheidung
Groß/Klein>, <Trennzeichen>, <AND oder OR>,<Bereiche>])
|
||||||||||||
|
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 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:
|
||||||||||||
|
Parameter: |
|
||||||||||||
|
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: |
|