Manuel des Scripts Automation Engine > Organisation fonctionnelle > Chaînes de caractères > STR_MATCH

STR_MATCH

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

Syntaxe

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

Syntaxe

Description / format

Chaîne de caractères1

Chaîne de caractères alphanumérique devant être comparée.
Format : littéral de script ou variable de script

Chaîne de caractères2

Chaîne de caractères alphanumérique devant être comparée.
Format : littéral de script ou variable de script  

Caractère générique 1

Caractère représentant n'importe quel caractère
Format : littéral de script ou variable de script
Valeur par défaut : "*"

Caractère générique 2

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.

Remarques

La fonction de script compare si chaîne de caractères2 est identique à chaîne de caractères1. 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ères2 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 attribués à la chaîne de caractères1 et/ou à la chaîne de caractères2.

Exemple

Le premier exemple affiche le résultat "N" dans le protocole d'activation.

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

Le deuxième exemple utilise des caractères génériques pour la comparaison. Le résultat "Y" est affiché dans le protocole d'activation.

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

Le troisième exemple utilise un caractère générique défini de manière explicite. Le résultat "Y" est affiché dans le protocole d'activation.

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

Le quatrième exemple utilise aussi un caractère générique. Il désigne toutefois un seul caractère. Par conséquent, le résultat est "N".

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

 

Rubriques connexes :

Eléments de script - Chaînes

Généralités sur les scripts
Eléments de script - Liste alphabétique

Eléments de script - Répartition fonctionnelle