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

STR_MATCH

Script-Funktion: Vergleicht zwei Zeichenketten.

Syntax

STR_MATCH(String1, String2, [Wildcard1], [Wildcard2])

Syntax	Beschreibung/Format
Zeichenkette1	Alphanumerische Zeichenfolge, welche verglichen werden soll. Format: Script-Literal oder Script-Variable
Zeichenkette2	Alphanumerische Zeichenfolge, welche verglichen werden soll. Format: Script-Literal oder Script-Variable
Wildcard1	Wildcardzeichen für beliebige Zeichen. Format: Script-Literal oder Script-Variable Standard: "*"
Wildcard2	Wildcardzeichen für genau ein Zeichen. Format: Script-Literal oder Script-Variable Standardwert: "_"

Rückgabewert
"Y" - Die beiden Zeichenketten sind identisch. "N" - Die beiden Zeichenketten sind unterschiedlich.

Anmerkungen

Die Script-Funktion vergleicht, ob Zeichenkette2 mit Zeichenkette1 identisch ist. Dabei wird zwischen Groß- und Kleinschreibung unterschieden (case-sensitive).

In Zeichenkette2 können Wildcardzeichen verwendet werden, um ein Raster für den Vergleich zu bilden. Standardmäßig steht "*" dabei für beliebige, "_" für genau ein Zeichen.

Es können auch andere Wildcardzeichen verwendet und Wildcard1 und/oder Wildcard2 zugewiesen werden.

Ab Version 11 der Automation Engine wurde die Länge der Variablen geändert.
Wenn daher eine Variable ein Leerzeichen enthält, ergibt die Prüfung einer Variable der Länge 0 den Wert "N", wie das folgende Beispiel zeigt:

:SET&TEST# = GET_VAR(‚VARA.TEST‘,‘KEY_DOES_NOT_EXIST‘)
:SET&TRUE#=STR_MATCH(&TEST#,"")

Beispiele

Das erste Beispiel gibt das Ergebnis "N" im Aktivierungsprotokoll aus.

:SET &RET# = STR_MATCH("UserInterface", "User-Interface")
:PRINT &RET#

Das zweite Beispiel verwendet Wildcardzeichen zum Vergleich. Das Ergebnis "Y" wird im Aktivierungsprotokoll ausgegeben.

:SET &RET# = STR_MATCH("UserInterface", "U*I*")
:PRINT &RET#

Das dritte Beispiel verwendet ein Wildcardzeichen, welches explizit festgelegt wird. Das Ergebnis "Y" wird im Aktivierungsprotokoll ausgegeben.

:SET &RET# = STR_MATCH("UserInterface", "User#", "#")
:PRINT &RET#

Im vierten Beispiel wird ebenfalls ein Wildcardzeichen verwendet. Dieses steht jedoch für genau ein Zeichen. Deshalb lautet das Ergebnis "N".

:SET &RET# = STR_MATCH("UserInterface", "User#",, "#")
:PRINT &RET#

Siehe auch:

Script-Sprachmittel - Strings
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