Aide:StringReplace.txt

Document original V3.3.6.1 :

###Function###
StringReplace

###Description###
Replaces substrings in a string.

###Syntax###
StringReplace ( "string", "searchstring/start", "replacestring" [, occurrence [, casesense]] )


###Parameters###
@@ParamTable@@
string
	The string to evaluate.
searchstring/start
	The substring to search for or the character position to start the replacement.
replacestring
	The replacement string.
occurrence
	[optional] The number of times to replace the searchstring. Use a negative occurrence to replace from the right side.
	0 = all searchstrings will be replaced (default)
casesense
	[optional] Flag to indicate if the operations should be case sensitive.
	0 = not case sensitive, using the user's locale (default)
	1 = case sensitive
	2 = not case sensitive, using a basic/faster comparison
@@End@@


###ReturnValue###
Returns the new string, the number of replacements performed is stored in @extended.


###Remarks###
By default or if count is positive the search/replace is performed left-to-right.  Thus, StringReplace("aaa", "aa", "bb") returns "bba"

If the start method is used the occurrence and casesense parameters are ignored. If the replacestring cannot be stored a blank string is returned and @error is set to 1.

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


###Example###
@@IncludeExample@@

Document traduit V3.3.6.1 :

###Function###
StringReplace

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


###Syntax###
StringReplace ( "string", "searchstring/start", "replacestring" [, occurrence [, casesense]] )


###Parameters###
@@ParamTable@@
string
	La chaîne à évaluer.
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 remplacement de la chaîne recherchée. Utiliser 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.
	0 = insensible à la casse, utilise les paramètres locaux de l'utilisateur (par défaut)
	1 = sensible à la casse
	2 = insensible à la casse, utilise une comparaison basique/rapide
@@End@@


###ReturnValue###
Retourne la nouvelle chaîne, le nombre de remplacements effectués est stocké dans @extended.


###Remarks###
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 du caractère de départ est utilisée les paramètres occurrence et casesense sont ignorés. Si la chaîne de remplacement ne peut être stockée, une chaîne vide est retournée et @error est mis à 1.


###Related###
<a href="StringLeft.htm">StringLeft</a>, <a href="StringLen.htm">StringLen</a>, <a href="StringLower.htm">StringLower</a>, <a href="StringMid.htm">StringMid</a>, <a href="StringRight.htm">StringRight</a>, <a href="StringTrimLeft.htm">StringTrimLeft</a>, <a href="StringTrimRight.htm">StringTrimRight</a>, <a href="StringUpper.htm">StringUpper</a>, <a href="StringStripWS.htm">StringStripWS</a>, <a href="StringAddCR.htm">StringAddCR</a>

###Example###
@@IncludeExample@@

Traducteur : Alex74

Contributeurs (pour les modifications avant le Wiki) : matwachich, Tlem