f$PGSuche (f$PGsearch)

Suchen einer Zeile in einer indizierten Parametergruppe. Es wird ab dem angegebenen Startindex nach Zeilen gesucht, die den angegebenen Kriterien entsprechen. Alle angegebenen Kriterien müssen erfüllt sein, damit die Zeile als Treffer verwendet wird. Falls die Kriterienparametergruppe leer ist, oder ein Leerstring übergeben wird, wird –1 als Ergebnis zurückgeliefert. Die Kriterien werden als indizierte Parametergruppe mit folgenden Parametern übergeben (Als Parametergruppendefinition kann tdv:PGSuche_Kriterien verwendet werden):

Name

Name des zu prüfenden Parameters der Parametergruppe. Bei Angabe eines nicht existierenden Parameters wird –1 zurückgegeben.

Vergleich

Vergleichsoperator.

Folgende Operatoren sind bei Zahlenwerten möglich:

=, !=, <, <=, >,>=

Folgende Operatoren sind bei Zeichenketten möglich:

=, !=, beginnt mit, enthält, endet mit oder starts with, contains, ends with

Wert

Vergleichswert

Bitte beachten: Der Name der Parametergruppen wird in der Regel als Zeichenketten-Konstante übergeben, also in Anführungszeichen eingeschlossen.

Syntax:	Index = f$PGSuche ( PGName , Startindex , KriterienPG )
	Argument	Typ	Bedeutung
	PGName	Zeichenkette	Name der Parametergruppe, die durchsucht werden soll
	Startindex	Ganzzahlig	Startindex in der Parametergruppe, ab der gesucht werden soll.
	KriterienPG	Zeichenkette	Name der Parametergruppe mit den Kopierkriterien
Ergebnis:	> 0	Index der gefundenen Zeile
	-1	Die Suche war nicht erfolgreich bzw. die Parametergruppe existiert nicht.
	-3	Die Parametergruppe ist falsch indiziert.
Beispiel:	iZeile = f$PGSuche ( 'Aufgaben' , iZeile + 1 , 'Kriterien' )