STR_FIND

Script-Funktion: Sucht ein Zeichen oder einen String innerhalb eines Strings.

Syntax

STR_FIND (String1, String2[, Start])

Syntax	Beschreibung/Format
String1	Alphanumerischer String, in dem gesucht werden soll. Format: Script-Literal oder Script-Variable
String2	Einzelnes Zeichen oder alphanumerischer String, der gesucht wird. Format: Script-Literal oder Script-Variable
Start	Position, ab der die Suche beginnen soll. Format: Zahl ohne Anführungszeichen Standardwert: 1

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

Die Funktion STR_FIND sucht den String2 innerhalb von String1 und beginnt dabei ab Start mit der Suche. Wenn Start nicht angegeben ist, beginnt die Suche an Position 1. String2 kann aus einem Zeichen bestehen. Die Groß- und Kleinschreibung wird bei der Suche nicht berücksichtigt.

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

Beispiele

Das folgende Script gibt die Position innerhalb eines Strings zurück, an der ein bestimmter String gefunden wird.

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

Das Ergebnis ist 4, da das erste Zeichen des Suchbegriffs das vierte Zeichen in dem String ist.

Im folgenden Beispiel gibt die Suche nach dem Zeichen # im String 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: