STR_MATCH

Script-Funktion: Vergleicht zwei Strings

Syntax

STR_MATCH (String1, String2[, Platzhalterzeichen1[, Platzhalterzeichen2]])

Syntax	Beschreibung/Format
String1	Alphanumerischer String, der verglichen werden soll Format: Script-Literal oder Script-Variable
String2	Alphanumerischer String, der verglichen werden soll Format: Script-Literal oder Script-Variable
Platzhalterzeichen1	Zeichen, das für ein beliebiges Zeichen steht Format: Script-Literal oder Script-Variable Standard: "*"
Platzhalterzeichen2	Zeichen, das für genau ein Zeichen steht Format: Script-Literal oder Script-Variable Standard: "_"

Rückgabewert
"Y" - Die beiden Strings sind identisch "N" - Die beiden Strings sind nicht identisch

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

In String2 können Platzhalterzeichen 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 Platzhalterzeichen verwendet und Platzhalterzeichen1 und/oder Platzhalterzeichen2 zugewiesen werden.

Achtung! Ab v11 der Automation Engine wurde die Länge der Variablen geändert.
Wenn eine Variable also ein Leerzeichen enthält, gibt die Überprüfung einer Variable mit der Länge 0 den Wert "N" zurück, wie in diesem Beispiel:

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

Beispiele

Die folgenden Beispiel-Strings 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 Strings 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 Strings 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 Strings nicht überein, so dass das negative Ergebnis (N) im Aktivierungsreport ausgegeben wird.

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

Siehe auch: