<<

Inhaltsverzeichnis

Suchen

>>

 

SEARCH

 

 

Funktion

 

 

Syntax:

SEARCH(<Indexdateiname>, <Suchart>, <Suchen nach>, <Maximale Anzahl Datensätze>, <Unterscheidung Groß/Klein>, <Nur Zählen>, <Dateiname>, <Trennzeichen>, <AND oder OR> [,<Randomdatei> [,<Von>,<Bis>]])

 

<Indexdateiname>

= <INDEXDATEI>

<Suchart>

= <NUM-AUSDRUCK>

<Suchen nach>

= <STRING-AUSDRUCK>

<Maximale Anzahl Datensätze>

= <NUM-AUSDRUCK>

<Unterscheidung Groß/Klein>

= <NUM-AUSDRUCK>

<Nur Zählen>

= <NUM-AUSDRUCK>

<Dateiname>

= <STRING-VARIABLE>

<Trennzeichen>

= <STRING-AUSDRUCK>

<AND oder OR>

= <NUM-AUSDRUCK>

<Randomdatei>

= <NUM-AUSDRUCK>

<Von>

= <NUM-AUSDRUCK>

<Bis>

= <NUM-AUSDRUCK>

 

 

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:

Indexdateiname

Name der Indexdatei

 

Suchart

1: alle gefundenen Datensätze

0: alle nicht gefundenen Datensätze (Komplementärmenge)

 

Suchen nach

Suchstring

 

Maximale Anzahl Datensätze

<=0: Die gesamte Indexdatei wird durchsucht.

>0: Legt fest, wie viele Datensätze maximal gefunden werden sollen.

 

Unterscheidung Groß/Klein

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

0: Keine Unterscheidung zwischen Groß- und Kleinschreibung

 

Nur Zählen

<> 0: Die gefundenen Datensätze werden nur gezählt.

 = 0: Die gefundenen Datensätze werden in <Dateiname> gespeichert.

 

Dateiname

Datei, in die die gefundenen Datensätze geschrieben werden.

 

Trennzeichen

Trennzeichen für mehrere Suchstrings

 

AND oder OR

Verknüpfungsart bei mehreren Suchstrings:

1 = AND

sonst = OR

 

Randomdatei

<> 0: Eine Randomdatei wird erzeugt.

= 0: Eine sequentielle Datei wird erzeugt.

 

Von

Suchen im Datensatz ab dieser Byteposition

 

Bis

Suchen im Datensatz bis zu dieser Byteposition

 

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:

START

READ

GET_FIRST_RECORD

GET_NEXT_RECORD