STR_FIND

Script-Funktion: Sucht ein Zeichen oder eine Zeichenkette innerhalb einer Zeichenkette.

Syntax

STR_FIND (String1, String2[, Start])

Syntax	Beschreibung/Format
String1	Alphanumerische Zeichenfolge in der gesucht werden soll. Format: Script-Literal oder Script-Variable
String2	Einzelnes Zeichen oder alphanumerische Zeichenfolge, die gesucht wird. Format: Script-Literal oder Script-Variable
Start	Position, ab der die Suche beginnen soll. Format: Zahl ohne Hochkommata Standardwert: 1

Rückgabewerte
Position, an der das Zeichen oder die Zeichenkette gefunden wurde. "0" - Das Zeichen oder die Zeichenkette wurde nicht gefunden

Die Funktion STR_FIND sucht die Zeichenkette2 innerhalb der Zeichenkette1 und beginnt dabei ab Start mit der Suche. Wird Start nicht angegeben, beginnt die Suche ab Position 1. Die Zeichenkette2 darf auch aus einem einzigen Zeichen bestehen. Groß- und Kleinschreibung wird daher nicht berücksichtigt.

Die Script-Funktion liefert die erste Position, an der die Zeichenkette2 gefunden wurde, als Wert zurück. Die Position wird dabei immer vom Anfang der Zeichenkette1 gezählt, nicht etwa ab Start.

Beispiele

Das folgende Script gibt die Position innerhalb einer Zeichenkette zurück, an der eine bestimmte Zeichenkette gefunden wird.

:SET &LOCATION# = STR_FIND("AE system", "system")

Das Ergebnis ist 4, da das erste Zeichen des Suchbegriffs das vierte Zeichen in der Zeichenkette ist.

Im folgenden Beispiel gibt die Suche nach dem Zeichen # in der Zeichenkette Automic#01, Automic#02 den Wert 8 zurück:

:SET &STRING#="Automic#01, Automic#02"
:SET &SEARCHSTRING#="#"
:SET &POS#=STR_FIND(&STRING#,&SEARCHSTRING#)
:PRINT &POS#

Im folgenden Beispiel beginnt die Suche an Position 2, sodass die Position des Suchbegriffs bei 13 liegt.

:SET &POS#=STR_FIND("AUTOMIC#01, AUTOMIC#02","AUTOMIC", 2)

:PRINT &POS#

Siehe auch: