StringReplace()

Remplace ou modifie des parties spécifiques d'une chaîne paramètre et renvoie le résultat.

Catégorie

Chaîne

Syntaxe

StringResult = StringReplace( Text, SearchFor, ReplaceWith, CaseSens, NumToReplace, MatchWholeWords );

Paramètres

Texte

Chaîne dont des caractères, des mots ou des phrases vont être remplacés. Chaîne littérale ou attribut chaîne.

chercherChaine

La chaîne à rechercher et à remplacer. Chaîne littérale ou attribut chaîne.

remplacerPar

Chaîne de remplacement. Chaîne littérale ou attribut chaîne.

modeCasse

Détermine si la recherche respecte la casse. (0=non et 1=oui) Tout attribut de nombre ou d’entier.

nbRemplacements

Détermine le nombre d'occurrences à remplacer. Tout nombre ou attribut entier. Pour indiquer toutes les occurrences, définissez cette valeur à -1.

motsEntiers

Détermine si la fonction limite les remplacements aux mots entiers. (0=non et 1=oui) Tout attribut de nombre ou d’entier. Si le paramètre motsEntiers est activé (il vaut 1) et que chercherChaine est défini à « jour », alors la séquence « jour » dans le mot « journal » n'est pas remplacée. Si le paramètre motsEntiers est désactivé (il vaut 0), la séquence et remplacée partout.

Remarques

Utilisez cette fonction pour remplacer des caractères, des mots ou des phrases à l'intérieur d'une chaîne.

La fonction StringReplace() ne reconnaît pas les caractères spéciaux, tels que @ # $ % & * ( ). Ces caractères sont interprétés comme des délimiteurs. Par exemple, si la fonction StringReplace() (abc#,abc#,1234,0,1,1) est traitée, il n'y aura pas de remplacement. En effet, le symbole # est considéré comme un séparateur et non comme un caractère.

Exemples

StringReplace("Dans dedans","Dans","Hors",0,1,0) ' renvoie "Hors dedans" (remplace la première occurrence);

StringReplace("Dans dedans","Dans","Hors",0,-1,0) ' renvoie "Hors deHors" (remplace toutes les occurrences);

StringReplace("Dans dedans","Dans","Hors",1,-1,0) ' renvoie "Hors dedans" (remplace en respectant la casse);

StringReplace("Dans dedans","Dans","Hors",0,-1,1) ' renvoie "Hors dedans" (remplace seulement les mots entiers);

Voir également

StringASCII()

StringChar()

StringFromIntg()

StringFromReal()

StringFromTime()

StringInString()

StringLeft()

StringLen()

StringLower()

StringMid()

StringRight()

StringSpace()

StringTest()

StringToIntg()

StringToReal()

StringTrim()

StringUpper()

Text()