f$PGSearch (f$PGSuche)

Search for a line in an indexed parameter group. Lines which meet the entered criteria are searched for from the entered start index. All entered criteria must be met for the line to be used as a match. If the criteria parameter group is empty or an empty string entered, –1 is returned as the result. The criteria are entered as an indexed parameter group with the following parameters:

Name

Name of the parameter in the parameter group to be checked. If a parameter is entered that does not exist, –1 is returned.

Comparison

Comparison operators.

The following operators are possible with numeric values:

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

The following operators are possible with strings:

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

Value

Comparison value

Please note: the name of the parameter groups is usually entered in string constants, i.e. in quotation marks.

Syntax:	Index = f$PGSearch ( PGName , Startindex , CriteriaPGName )
	Argument	Type	Meaning
	PGName	String	Name of the parameter group to be searched through
	Startindex	Integer	Start index in the parameter group from which the search begins.
	CriteriaPGName	String	Name of the parameter group with the copying criteria
Result:	> 0	Index of the line found
	-1	The search was unsuccessful or the parameter group does not exist.
	-3	The parameter group is incorrectly indexed.
Example:	iZeile = f$PGSuche ( 'Aufgaben' , iZeile + 1 , 'Kriterien' )