STR_MATCH

Script-Funktion: Vergleicht zwei Zeichenfolgen

Syntax

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

Syntax	Beschreibung/Format
String1	Alphanumerische Zeichenfolge, welche verglichen werden soll. Format: Script-Literal oder Script-Variable
String2	Alphanumerische Zeichenfolge, welche verglichen werden soll. Format: Script-Literal oder Script-Variable
Wildcard1	Zeichen, das ein beliebiges Zeichen darstellt Format: Script-Literal oder Script-Variable Standard: "*"
Wildcard2	Wildcardzeichen für genau ein Zeichen Format: Script-Literal oder Script-Variable Standard: „ _ “

Rückgabewert
„Y“ - Die beiden Zeichenfolgen sind identisch „N“ - Die beiden Zeichenfolgen sind nicht identisch

Diese Script-Funktion vergleicht, ob Zeichenkette2 mit Zeichenkette1 identisch ist. Es wird zwischen Groß- und Kleinschreibung unterschieden.

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 Platzhalter1 und/oder Platzhalter2 zugewiesen werden.

Ab v11 der Automation Engine wurde die Länge der Variablen geändert.
Wenn also eine Variable ein Leerzeichen enthält, gibt die Prüfung auf eine Variable der Länge 0 den Wert „N“ zurück, wie es dieses Beispiel ergeben würde:

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

Beispiele

Die folgenden Beispiel-Zeichenfolgen sind nicht identisch, so dass dieses Script einen negativen Rückgabewert (N) liefert.

:SET &COMPARISON# = STR_MATCH("AE", "global")

Das folgende Beispiel verwendet ein Platzhalterzeichen als Vergleich. Die Zeichenfolgen stimmen überein, so dass das positive Ergebnis (Y) im Aktivierungsreport ausgegeben wird.

:SET &RET# = STR_MATCH("PromptSet", "P*S*")
:PRINT &RET#

Das folgende Beispiel verwendet ein Platzhalterzeichen, das explizit angegeben wird. Die Zeichenfolgen stimmen überein, so dass das positive Ergebnis (Y) im Aktivierungsreport ausgegeben wird.

:SET &RET# = STR_MATCH("PromptSet", "Prompt#", "#")
:PRINT &RET#

Das folgende Beispiel enthält ein Platzhalterzeichen, das für genau ein Zeichen steht. In diesem Fall stimmen die Zeichenfolgen nicht überein, so dass das negative Ergebnis (N) im Aktivierungsreport ausgegeben wird.

:SET &RET# = STR_MATCH("PromptSet", "Prompt#",, "#")
:PRINT &RET#

Siehe auch: