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

STR_SUBSTITUTE

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

Syntaxe

STR_SUB[STITUTE] (Chaîne de caractères, [Ancienne] [,Nouvelle])

Elément de syntaxe

Description/format

Chaîne de caractères

Chaîne de caractères alphanumérique dans laquelle des remplacements doivent être réalisés.
Format: Littéral de script ou Variable de script

Ancienne

Chaîne de caractères alphanumérique devant être remplacée dans la chaîne de caractères.
Format: littéral de script ou Variable de script
Valeur par défaut : " " 

Nouveau

Chaîne de caractères alphanumérique devant remplacer Ancienne.
Format: littéral de script ou Variable de script
Valeur par défaut : " "

Code retour

Chaîne de caractères devant être créée par le remplacement.

Remarques

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

Ancien et Nouveau ne peuvent pas contenir plus de 1024 caractères et sont utilisés en option. Si Ancien n'a pas été indiqué comme paramètre, chaque espace est remplacé par Nouveau via le caractère ou la chaîne de caractères. Si Nouveau n'est pas utilisé comme paramètre, Ancien est remplacé par un espace.

Si Ancien n'apparaît pas dans Base, la fonction renvoie la chaîne de caractères indiquée dans Base.

La fonction de script peut également servir à effacer Ancien de la chaîne de caractères. Pour cela, deux guillemets successifs (sans espace) doivent être indiqués comme Nouveau.

Exemple

Dans le premier exemple, le caractère "A" est remplacé par le caractère "B". Le résultat "BBBBB" est affiché dans le protocole d'activation.

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

Le deuxième exemple remplace la chaîne de caractères "AAAAA" par le caractère "B". Le résultat "B" est affiché dans le protocole d'activation.

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

Dans le troisième exemple, la chaîne de caractères "AA" est remplacée par la chaîne de caractères "BB". Le résultat "BBBBA" est affiché dans le protocole d'activation.

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

Le quatrième exemple efface les espaces de la chaîne de caractères. Le résultat "UC4" est affiché dans le protocole d'activation.

:SET &RET# = STR_SUB ("U C 4", " ", "")
:PRINT&RET#

 

Rubriques connexes :

Scripts - Chaînes

Généralités sur les scripts
Elément de script - Liste alphabétique
Elément de script - Division fonctionnelle