SEARCH
|
Syntax: |
SEARCH(<Indexdateiname>,
<Suchart>, <Suchen nach>, <Maximale Anzahl Datensätze>,
<Unterscheidung Groß/Klein>, <Nur Zählen>, <Dateiname>,
<Trennzeichen>, <AND oder OR> [,<Randomdatei>
[,<Von>,<Bis>]])
|
||||||||||||||||||||||||
|
|
|
||||||||||||||||||||||||
|
Bedeutung: |
Führt
eine Volltextsuche in einer Indexdatei durch. SEARCH
führt eine Volltextsuche über die gesamte Indexdatei durch. Gesucht wird
in den einzelnen Datensätzen nach <Suchen nach>. <Suchart>
legt fest, ob alle gefundenen oder alle nicht gefundenen Datensätze geliefert
werden. Wenn <Suchen nach> gefunden wird und <Suchart> ungleich 0
ist oder <Suchen nach> nicht gefunden wird und <Suchart> gleich 0
ist, so wird der komplette Datensatz im Format RECORD$(<INDEXDATEI>)
in die sequentielle Datei <Dateiname> geschrieben. Bei <Suchart>
= 0 wird also die Komplementärmenge geliefert, das sind alle Datensätze, die
<Suchen nach> nicht enthalten. Ist
<Randomdatei> = 0 oder fehlt der Parameter <Randomdatei>, so wird
eine sequentielle Datei erzeugt, in der die einzelnen Datensätze durch einen
Zeilenvorschub EBUS_LINEFEED$ getrennt
sind. Ist
<Randomdatei> = 0 <> 0, so wird eine Randomdatei erzeugt, in der
die gefundenen Datensätze ohne Zeilentrennung abgespeichert werden. Dieser
Dateityp ist dann sinnvoll, wenn in den Datensätzen Zeilenvorschübe (z.B. in
Textdaten) vorkommen. Ist
<Maximale Anzahl Datensätze> <> 0, so legt <Maximale Anzahl
Datensätze> fest, wie viele Datensätze maximal gefunden werden sollen.
Wird diese Anzahl erreicht, wird die Suche beendet. Ist
<Unterscheidung Groß/Klein> <> 0, so wird bei der Suche zwischen
Groß- und Kleinbuchstaben unterschieden, andernfalls nicht. Ist
<Nur Zählen> <> 0, so werden die gefundenen Datensätze nur
gezählt und nicht in die Datei <Dateiname> geschrieben.
<Dateiname> ist dann ohne Bedeutung. <Dateiname>
enthält den Namen der Datei, in die die gefundenen Datensätze geschrieben werden.
Ist <Dateiname> = "", so wird automatisch eine temporäre
Datei erzeugt. Der Name dieser Datei steht nach dem Aufruf der Funktion
SEARCH in der Variablen <Dateiname>. 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. <Von>
und <Bis> legen den Bereich im Datensatz fest, in dem gesucht werden
soll. Ist <Von> = 0 oder <Bis> < <Von> oder fehlen die
Parameter <Von> und <Bis>, so wird im gesamten Datensatz gesucht. SEARCH
liefert als Ergebnis die Anzahl der gefundenen Datensätze. Im Fehlerfall
liefert SEARCH als Ergebnis -1 und in den Variablen OK
und OK2 steht der Fehlercode. |
||||||||||||||||||||||||
|
Parameter: |
|
||||||||||||||||||||||||
|
Beispiel: |
/* Alle Datensätze suchen, die Herr enthalten DATEI$ = "HILF.DAT" H% = SEARCH(KUNDEN,1,"Herr",0,0,0,DATEI$,"",0) ERRORMES = STR$(H%) + " Datensätze
gefunden" /* Alle Datensätze suchen, die Herr nicht enthalten H% = SEARCH(KUNDEN,0,"Herr",0,0,0,DATEI$,"",0) /* Alle Datensätze suchen, die Herr und Frau enthalten H% = SEARCH(KUNDEN,1,"Herr;Frau",0,0,0,DATEI$,";",1) /* Alle Datensätze suchen, die Herr oder Frau enthalten H% = SEARCH(KUNDEN,1,"Herr;Frau",0,0,0,DATEI$,";",0) /* Alle Datensätze suchen, die nicht Herr und Frau enthalten H% = SEARCH(KUNDEN,0,"Herr;Frau",0,0,0,DATEI$,";",1) /* Alle Datensätze suchen, die weder Herr noch Frau enthalten H% = SEARCH(KUNDEN,0,"Herr;Frau",0,0,0,DATEI$,";",0) |
||||||||||||||||||||||||
|
Siehe
auch: |
|