STR_MATCH

Use the STR_MATCH script function to compare whether the two strings String2 and String1 are identical. The comparison is case sensitive, so upper and lower case are distinguished.

Syntax

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

STR_MATCH
Compares two strings
String1
Alphanumeric character string that should be compared
Format: script literal or script variable
String2
Alphanumeric character string that should be compared. You can use wildcard characters to form a comparison pattern where "*" stands for any character and "_" for exactly one.
Format: script literal or script variable
Wildcard1
(Optional) Character that represents any character. You can use and assign any wildcard characters.
Format: script literal or script variable
Default: "*"
Wildcard2
(Optional) Character that represents any character. You can use and assign any wildcard characters.
Format: script literal or script variable
Default: "*"

Return codes

Y
The two strings are identical
N
The two strings are not identical

Note: If a variable contains a blank, the check for a variable length that is zero returns the value "N" as the following example shows:

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

Examples

The sample strings below are not the same, so this script returns a negative code (N).

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

The following example uses a wildcard character for comparison. The strings match, so the positive result (Y) is printed in the activation report.

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

The following example uses a wildcard character that is explicitly specified. The strings match, so the positive result (Y) is printed in the activation report.

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

The following example includes a wildcard character that stands for exactly one character. In this case, the strings do not match, so the negative result (N) is printed in the activation report.

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