STR_MATCH

Fonction de script : Compare deux chaînes de caractères

Syntaxe

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

Syntaxe	Description / format
String1	Chaîne de caractères alphanumérique à comparer. Format : littéral de script ou variable de script
String2	Chaîne de caractères alphanumérique à comparer. Format : littéral de script ou variable de script
Wildcard1	Caractère représentant n'importe quel caractère Format : littéral de script ou variable de script Par défaut : "*"
Wildcard2	Caractère représentant un caractère Format : littéral de script ou variable de script Valeur par défaut : "_"

Code retour
"Y" : les deux chaînes de caractères sont identiques. "N" : les deux chaînes de caractères sont différentes.

La fonction de script compare si String2 est identique à String1. Les majuscules et les minuscules sont différenciées (sensible à la casse).

Des caractères génériques peuvent être utilisés dans la chaîne de caractères 2 pour créer une trame de comparaison. Par défaut, "*" signifie n'importe quelle chaîne de caractères et "_" exactement un caractère.

D'autres caractères génériques peuvent être utilisés et affectés à Wildcard1 et/ou Wildcard2.

À partir de la v11 de Automation Engine, la longueur des variables a changé.
Par conséquent, si une variable contient un espace vide, la vérification d'une variable de longueur 0 renvoie la valeur "N", comme le montre cet exemple :

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

Exemples

Les chaînes ci-dessous n'étant pas les mêmes, le script renvoie un code retour négatif (N).

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

L'exemple suivant illustre l'utilisation des caractères génériques pour la comparaison. Les chaînes correspondent, donc le résultat positif (Y) est écrit dans le rapport d'activation.

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

L'exemple suivant illustre l'utilisation d'un caractère générique explicitement spécifié. Les chaînes correspondent, donc le résultat positif (Y) est écrit dans le rapport d'activation.

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

L'exemple suivant contient un caractère générique qui représente un et un seul caractère. Dans ce cas, les chaînes ne correspondent pas et le résultat négatif (N) est donc écrit dans le rapport d'activation.

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

Voir aussi :