Functions > String >


StringReplace

Remplace des sous-chaînes dans une chaîne.

StringReplace ( "string", "searchstring/start", "replacestring" [, occurrence = 0 [, casesense = 0]] )

Paramètres

string La chaîne d'origine.
searchstring/start La sous-chaîne à rechercher ou la position du caractère de départ du remplacement.
replacestring La chaîne de remplacement.
occurrence [optionnel] Le nombre de remplacements à effectuer. Utilisez une occurrence négative pour remplacer à partir de la droite.
    0 = Toutes les occurrences seront remplacées (par défaut)
casesense [optionnel] Paramètre pour indiquer si les opérations doivent être sensibles à la casse.
    $STR_NOCASESENSE (0) = insensible à la casse, utilise les paramètres locaux de l'utilisateur (par défaut)
    $STR_CASESENSE (1) = sensible à la casse
    $STR_NOCASESENSEBASIC (2) = insensible à la casse, utilise une comparaison simple/rapide

Les constantes sont définies dans "StringConstants.au3"

Valeur de retour

Retourne la nouvelle chaîne, le nombre de remplacements effectués est indiqué par la macro @extended.

Remarques

Par défaut ou si le paramètre occurrence est positif, la recherche/remplacement est effectuée de gauche à droite. Ainsi, StringReplace("aaa", "aa", "bb") retourne "bba"

Si la méthode de la position de départ est utilisée, les paramètres occurrence et casesense sont ignorés. La fonction remplacera les caractères dans "string", en commençant à la position donnée, avec les caractères dans "replacestring" - autant de caractères seront remplacés qu'indiqué par "replacestring". Cependant, s'il n'y a pas assez de caractères dans "string" pour que "replacestring" soit inséré en entier, une chaîne vide est retournée et @error est mis à 1.

En relation

StringAddCR, StringLeft, StringLen, StringLower, StringMid, StringRight, StringStripWS, StringTrimLeft, StringTrimRight, StringUpper

Exemple

#include <MsgBoxConstants.au3>

; Remplace un espace ' ' par le caractère '-' (moins).
Local $sString = StringReplace("Ceci est une phrase avec espaces-blancs.", " ", "-")
Local $iReplacements = @extended
MsgBox($MB_SYSTEMMODAL, "", $iReplacements & " remplacements ont été effectués et la nouvelle chaîne est:" & @CRLF & @CRLF & $sString)