Automation Engine Script-Leitfaden > Funktionelle Gliederung > Strings > STR_FIND

STR_FIND

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

Syntax

STR_FIND(String1, String2, [Start])

Syntax	Beschreibung/Format
Zeichenkette1	Alphanumerische Zeichenfolge, in der gesucht werden soll. Format: Script-Literal oder Script-Variable
Zeichenkette2	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.

Kommentare

Die Funktion 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. Die Suche ist case-insensitiv.

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

in diesem Beispiel liefert die Suche nach "#" im String "Automic#01, Automic#02" den Wert 8.

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

Im folgenden Beispiel beginnt die Suche erst ab der 2. Stelle. Daher wird der String auf der Position 13 gefunden.

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

:PRINT &POS#

Siehe auch:

Script-Sprachmittel	Beschreibung
STR_FIND_REVERSE	Sucht ein Zeichen oder eine Zeichenkette innerhalb einer Zeichenkette. Die Suche beginnt am Ende der zu durchsuchenden Zeichenkette.

Script-Sprachmittel - Strings

Beispielsammlung
Benachrichtigung mit variablem Meldungstext

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel -Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support