STR_SUBSTITUTE

Fonction de script : Remplace des caractères ou une chaîne de caractères dans une chaîne de caractères.

Syntaxe

STR_SUB[STITUTE] (String, [Old] [,New])

Syntaxe	Description / format
String	Chaîne de caractères alphanumériques dans laquelle le remplacement doit être effectué Format : littéral de script ou variable de script
Old	Chaîne de caractères alphanumériques à remplacer dans la chaîne. Format : littéral de script ou variable de script Valeur par défaut :" "
New	Chaîne de caractères alphanumériques remplaçant Old Format : littéral de script ou variable de script Valeur par défaut :" "

Code retour
Chaîne de caractères créée par le remplacement des caractères

Cette fonction de script remplace un caractère ou une chaîne de caractères dans une chaîne de caractères.

Old et New sont optionnels et non limités. Si Old n'est pas spécifié en tant que paramètre, chaque espace vide est remplacé par le nouveau caractère ou la nouvelle chaîne. Si New n'est pas spécifié en tant que paramètre, Old est remplacé par un espace vide.

Si Old n'est pas inclus dans la chaîne, cette fonction renvoie la chaîne.

Cette fonction de script permet également de supprimer Old de la chaîne. Pour cela, il faut spécifier New avec deux guillemets successifs (sans espace vide).

Exemple

Le script suivant remplace la chaîne environment par la chaîne system, ce qui donne la chaîne AE system :

:SET &STRING# = STR_SUBSTITUTE("AE environment", "environment", "system")

Le script suivant remplace le caractère A par le caractère B. Le résultat BBBBB est écrit dans le rapport d'activation.

:SET &RET# = STR_SUBSTITUTE ("AAAAA", "A", "B")
:PRINT &RET#

Le script suivant remplace la chaîne de caractères AAAAA par le caractère B. Le résultat B est écrit dans le rapport d'activation.

:SET &RET# = STR_SUBSTITUTE ("AAAAA", "AAAAA", "B")
:PRINT &RET#

Le script suivant remplace la chaîne de caractères AA par la chaîne de caractères BB. Le résultat BBBBA est écrit dans le rapport d'activation.

:SET &STR1# = "AA"
:SET &STR2# = "BB"
:SET &RET# = STR_SUB ("AAAAA", &STR1#, &STR2#)
:PRINT &RET#

L'exemple suivant illustre la suppression des espaces vides dans une chaîne de caractères. Le résultat AE est écrit dans le rapport d'activation.

:SET &RET# = STR_SUB ("A E", " ", "")
:PRINT  &RET#

Voir aussi :