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)