diff options
Diffstat (limited to 'files/fr/web/javascript/reference/global_objects/string/replace/index.md')
| -rw-r--r-- | files/fr/web/javascript/reference/global_objects/string/replace/index.md | 96 |
1 files changed, 48 insertions, 48 deletions
diff --git a/files/fr/web/javascript/reference/global_objects/string/replace/index.md b/files/fr/web/javascript/reference/global_objects/string/replace/index.md index 3dbd06edb5..27d6d49033 100644 --- a/files/fr/web/javascript/reference/global_objects/string/replace/index.md +++ b/files/fr/web/javascript/reference/global_objects/string/replace/index.md @@ -14,7 +14,7 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/String/replace --- {{JSRef}} -La méthode **`replace()`** renvoie une nouvelle chaîne de caractères dans laquelle tout ou partie des correspondances à un `modèle` sont remplacées par un `remplacement`. Le `modèle` utilisé peut être une {{jsxref("RegExp")}} et le remplacement peut être une chaîne ou une fonction à appeler pour chaque correspondance. Si `modèle` est une chaîne de caractères, seule la première correspondance sera remplacée. +La méthode **`replace()`** renvoie une nouvelle chaîne de caractères dans laquelle tout ou partie des correspondances à un `modèle` sont remplacées par un `remplacement`. Le `modèle` utilisé peut être une {{jsxref("RegExp")}} et le remplacement peut être une chaîne ou une fonction à appeler pour chaque correspondance. Si `modèle` est une chaîne de caractères, seule la première correspondance sera remplacée. La chaîne de caractère originale reste inchangée. @@ -26,28 +26,28 @@ La chaîne de caractère originale reste inchangée. ### Paramètres -- `regexp` (modèle) - - : Un objet ou un littéral {{jsxref("RegExp")}}. La ou les correspondances sont remplacées par `nouvSouschn` ou par la valeur retournée par la `fonction` indiquée. -- `souschn` (modèle) - - : Une {{jsxref("String")}} qui est à remplacer par `nouvSouschn`. Elle est traitée comme une chaîne de caractères verbatim et elle n'est _pas_ interprétée comme une expression régulière. Seule la première occurrence sera remplacée. -- `nouvSouschn` (remplacement) - - : La {{jsxref("String")}} qui remplace la chaîne de caractères indiquée par le paramètre `regexp` ou `souschn`. Un certain nombre de modèles de remplacement spéciaux sont supportés ; voir la section "[Indiquer une chaîne de caractères comme paramètre](#Indiquer_une_chaîne_de_caractère_comme_paramètre)" ci-dessous. -- `fonction` (remplacement) - - : Une fonction à appeler pour créer la nouvelle sous-chaîne de caractères à utiliser pour remplacer la `regexp` ou la `souschn` donnée. Les arguments passés à cette fonction sont décrits dans la section "[Indiquer une fonction comme paramètre](#Indiquer_une_fonction_comme_paramètre)" ci-dessous. +- `regexp` (modèle) + - : Un objet ou un littéral {{jsxref("RegExp")}}. La ou les correspondances sont remplacées par `nouvSouschn` ou par la valeur retournée par la `fonction` indiquée. +- `souschn` (modèle) + - : Une {{jsxref("String")}} qui est à remplacer par `nouvSouschn`. Elle est traitée comme une chaîne de caractères verbatim et elle n'est _pas_ interprétée comme une expression régulière. Seule la première occurrence sera remplacée. +- `nouvSouschn` (remplacement) + - : La {{jsxref("String")}} qui remplace la chaîne de caractères indiquée par le paramètre `regexp` ou `souschn`. Un certain nombre de modèles de remplacement spéciaux sont supportés ; voir la section "[Indiquer une chaîne de caractères comme paramètre](#Indiquer_une_chaîne_de_caractère_comme_paramètre)" ci-dessous. +- `fonction` (remplacement) + - : Une fonction à appeler pour créer la nouvelle sous-chaîne de caractères à utiliser pour remplacer la `regexp` ou la `souschn` donnée. Les arguments passés à cette fonction sont décrits dans la section "[Indiquer une fonction comme paramètre](#Indiquer_une_fonction_comme_paramètre)" ci-dessous. ### Valeur retournée -Une nouvelle chaîne de caractères avec tout ou partie des correspondances du modèle remplacées par un remplacement. +Une nouvelle chaîne de caractères avec tout ou partie des correspondances du modèle remplacées par un remplacement. ## Description -Cette méthode ne change pas l'objet {{jsxref("String")}} auquel elle est appliquée. Elle retourne simplement une nouvelle chaîne de caractères. +Cette méthode ne change pas l'objet {{jsxref("String")}} auquel elle est appliquée. Elle retourne simplement une nouvelle chaîne de caractères. -Pour réaliser une recherche et remplacement global(e), incluez le commutateur `g` dans l'expression régulière. +Pour réaliser une recherche et remplacement global(e), incluez le commutateur `g` dans l'expression régulière. ### Indiquer une chaîne de caractère comme paramètre -La chaîne de caractère de remplacement peut inclure les modèles de remplacement spéciaux suivants : +La chaîne de caractère de remplacement peut inclure les modèles de remplacement spéciaux suivants : <table class="standard-table"> <tbody> @@ -81,11 +81,11 @@ La chaîne de caractère de remplacement peut inclure les modèles de remplace <td><code>$n</code></td> <td> <p> - Où <code><em>n</em></code> est un entier positif inférieur à 100. - Insère la <em>n</em> ième chaîne de sous-correspondance entre - parenthèses, à condition que le premier argument ait été un objet - {{jsxref("RegExp")}}. Notez que ceci est réalisé en - indices base 1. + Où <code><em>n</em></code> est un entier positif inférieur à 100. + Insère la <em>n</em> ième chaîne de sous-correspondance entre + parenthèses, à condition que le premier argument ait été un objet + {{jsxref("RegExp")}}. Notez que ceci est réalisé en + indices base 1. </p> </td> </tr> @@ -94,9 +94,9 @@ La chaîne de caractère de remplacement peut inclure les modèles de remplace ### Indiquer une fonction comme paramètre -Vous pouvez indiquer une fonction comme second paramètre. Dans ce cas, cette fonction sera appelée après que la recherche a été effectuée. Le résultat de la fonction (valeur retournée) sera utilisé comme chaîne de remplacement. (Note : les modèles de remplacement spéciaux mentionnés ci-dessus ne s'appliquent _pas_ dans ce cas). Notez que cette fonction sera appelée plusieurs fois, pour chaque correspondance complète à remplacer si l'expression régulière dans le premier paramètre est globale. +Vous pouvez indiquer une fonction comme second paramètre. Dans ce cas, cette fonction sera appelée après que la recherche a été effectuée. Le résultat de la fonction (valeur retournée) sera utilisé comme chaîne de remplacement. (Note : les modèles de remplacement spéciaux mentionnés ci-dessus ne s'appliquent _pas_ dans ce cas). Notez que cette fonction sera appelée plusieurs fois, pour chaque correspondance complète à remplacer si l'expression régulière dans le premier paramètre est globale. -Les arguments de cette fonction sont les suivants : +Les arguments de cette fonction sont les suivants : <table class="standard-table"> <tbody> @@ -115,14 +115,14 @@ Les arguments de cette fonction sont les suivants : <td><code>p1, p2, ...</code></td> <td> <p> - La <em>n</em>-ième chaîne de sous-correspondance entre parenthèses - capturantes, à condition que le premier argument de <code + La <em>n</em>-ième chaîne de sous-correspondance entre parenthèses + capturantes, à condition que le premier argument de <code >replace()</code > - soit un objet <code>RegExp</code>. (Correspond aux <code>$1</code>, - <code>$2</code>, etc. ci-dessus.) Par exemple, - si <code>/(\a+)(\b+)/</code> a été indiqué, <code>p1</code> correspond - à <code>\a+</code>, et <code>p2</code> à <code>\b+</code>. + soit un objet <code>RegExp</code>. (Correspond aux <code>$1</code>, + <code>$2</code>, etc. ci-dessus.) Par exemple, + si <code>/(\a+)(\b+)/</code> a été indiqué, <code>p1</code> correspond + à <code>\a+</code>, et <code>p2</code> à <code>\b+</code>. </p> </td> </tr> @@ -131,8 +131,8 @@ Les arguments de cette fonction sont les suivants : <td> Le décalage entre la sous-chaîne en correspondance à l'intérieur de la chaîne complète en cours d'analyse. (Par exemple, si la chaîne complète - était <code>'abcd'</code>, et que le chaîne en correspondance - était <code>'bc'</code>, alors cet argument vaudra 1.) + était <code>'abcd'</code>, et que le chaîne en correspondance + était <code>'bc'</code>, alors cet argument vaudra 1.) </td> </tr> <tr> @@ -142,14 +142,14 @@ Les arguments de cette fonction sont les suivants : </tbody> </table> -(Le nombre exact d'arguments varie suivant que le premier paramètre est ou non un objet {{jsxref("RegExp")}} et, dans ce cas, du nombre de sous-correspondances entre parenthèses qu'il indique.) +(Le nombre exact d'arguments varie suivant que le premier paramètre est ou non un objet {{jsxref("RegExp")}} et, dans ce cas, du nombre de sous-correspondances entre parenthèses qu'il indique.) -L'exemple suivant affectera `'abc - 12345 - #$*%'` à la variable `nouvelleChaine` : +L'exemple suivant affectera `'abc - 12345 - #$*%'` à la variable `nouvelleChaine` : ```js function remplaceur(correspondance, p1, p2, p3, decalage, chaine) { // p1 est non numérique, p2 numérique, et p3 non-alphanumérique - return [p1, p2, p3].join(' - '); + return [p1, p2, p3].join(' - '); } var nouvelleChaine = 'abc12345#$*%'.replace(/([^\d]*)(\d*)([^\w]*)/, remplaceur); console.log(nouvelleChaine); // abc - 12345 - #$*% @@ -157,9 +157,9 @@ console.log(nouvelleChaine); // abc - 12345 - #$*% ## Exemples -### Définition de l'expression régulière dans `replace()` +### Définition de l'expression régulière dans `replace()` -Dans l'exemple suivant, l'expression régulière est définie dans `replace()` et inclut l'indicateur d'indifférence à la casse. +Dans l'exemple suivant, l'expression régulière est définie dans `replace()` et inclut l'indicateur d'indifférence à la casse. ```js var chn = 'Twas the night before Xmas...'; @@ -171,9 +171,9 @@ Cela affiche 'Twas the night before Christmas...'. > **Note :** Voir [ce guide](/fr/docs/Web/JavaScript/Guide/Expressions_r%C3%A9guli%C3%A8res) pour plus d'explications concernant les expressions régulières. -### Utilisation de `global` et `ignore` avec `replace()` +### Utilisation de `global` et `ignore` avec `replace()` -Le remplacement global ne peut être fait qu'avec une expression régulière. Dans l'exemple suivant, l'expression régulière inclut les indicateurs global et indifférence à la casse, qui permettent à `replace()` de remplacer chaque occurrence de 'pommes' dans la chaîne par 'oranges'. +Le remplacement global ne peut être fait qu'avec une expression régulière. Dans l'exemple suivant, l'expression régulière inclut les indicateurs global et indifférence à la casse, qui permettent à `replace()` de remplacer chaque occurrence de 'pommes' dans la chaîne par 'oranges'. ```js var re = /pommes/gi; @@ -186,7 +186,7 @@ Cela affiche 'Les oranges sont rondes, et les oranges sont juteuses.'. ### Inverser des mots dans une chaîne de caractères -Le script suivant intervertit les mots dans la chaîne de caractères. Pour le texte de remplacement, le script utilise les modèles de remplacement `$1` et `$2`. +Le script suivant intervertit les mots dans la chaîne de caractères. Pour le texte de remplacement, le script utilise les modèles de remplacement `$1` et `$2`. ```js var re = /(\w+)\s(\w+)/; @@ -197,11 +197,11 @@ console.log(nouvChn); // Martin, Jean Cela affiche 'Martin, Jean'. -### Utilisation d'une fonction inline modifiant les caractères en correspondance +### Utilisation d'une fonction inline modifiant les caractères en correspondance -Dans cet exemple, toutes les occurrences des lettres majuscules sont converties en minuscules, et un tiret est inséré juste avant l'emplacement de la correspondance. La chose importante ici est que des opérations suppémentaires sont nécessaires sur l'élément en correspondance avant qu'il ne soit retourné comme remplacement. +Dans cet exemple, toutes les occurrences des lettres majuscules sont converties en minuscules, et un tiret est inséré juste avant l'emplacement de la correspondance. La chose importante ici est que des opérations suppémentaires sont nécessaires sur l'élément en correspondance avant qu'il ne soit retourné comme remplacement. -La fonction de remplacement accepte le fragment en correspondance comme paramètre, et elle l'utilise pour transformer sa casse et y concaténer le tiret avant de le retourner. +La fonction de remplacement accepte le fragment en correspondance comme paramètre, et elle l'utilise pour transformer sa casse et y concaténer le tiret avant de le retourner. ```js function styleFormatTiret(nomPropriete) { @@ -220,11 +220,11 @@ Du fait que nous voulons transformer davantage le résultat de la correspondance var nouvChn = nomPropriete.replace(/[A-Z]/g, '-' + '$&'.toLowerCase()); // ne fonctionne pas ``` -Ceci est dû au fait que `'$&'.toLowerCase()` serait d'abord évalué comme un littéral de chaîne (résultant en le même `'$&'`) avant d'utiliser les caractères comme modèle. +Ceci est dû au fait que `'$&'.toLowerCase()` serait d'abord évalué comme un littéral de chaîne (résultant en le même `'$&'`) avant d'utiliser les caractères comme modèle. -### Remplacer un degré Fahrenheit par son équivalent Celsius +### Remplacer un degré Fahrenheit par son équivalent Celsius -L'exemple suivant remplace des degrés Fahrenheit par leur équivalent en degrés Celsius. Les degrés Fahrenheit doivent être un nombre se terminant par F. La fonction renvoie le nombre en Celsius se terminant par C. Par exemple, si le nombre de départ est 212F, la fonction renvoie 100C. Si le nombre de départ est 0F, la fonction retourne -17.77777777777778C. +L'exemple suivant remplace des degrés Fahrenheit par leur équivalent en degrés Celsius. Les degrés Fahrenheit doivent être un nombre se terminant par F. La fonction renvoie le nombre en Celsius se terminant par C. Par exemple, si le nombre de départ est 212F, la fonction renvoie 100C. Si le nombre de départ est 0F, la fonction retourne -17.77777777777778C. L'expression régulière `test` vérifie tout nombre se terminant par F. Le nombre de degrés Fahrenheit est accessible à la fonction via son deuxième paramètre, `p1`. La fonction définit le nombre Celsius sur la base des degrés Fahrenheit transmis dans une chaîne à la fonction `f2c()`. `f2c()` renvoie ensuite le nombre Celsius. Cette fonction se rapproche de l'indicateur `s///e` de Perl. @@ -254,7 +254,7 @@ x-xxx-xx-x- x_x_x___x___x___ ``` -**Sortie :**Un tableau d'objets. Un `'x'` dénote un état `'marche'`, un `'-'` symbolise un état '`arret`' et un `'_'` (blanc souligné) symbolise la longueur d'un état `'marche'`. +**Sortie :**Un tableau d'objets. Un `'x'` dénote un état `'marche'`, un `'-'` symbolise un état '`arret`' et un `'_'` (blanc souligné) symbolise la longueur d'un état `'marche'`. ```json [ @@ -278,7 +278,7 @@ chn.replace(/(x_*)|(-)/g, function(correspondance, $1, $2){ console.log(tabRet); ``` -Ce fragment génère un tableau de 3 objets au format désiré sans utiliser de boucle `for`. +Ce fragment génère un tableau de 3 objets au format désiré sans utiliser de boucle `for`. ## Spécifications @@ -295,11 +295,11 @@ Ce fragment génère un tableau de 3 objets au format désiré sans utiliser de ## Notes spécifiques à Firefox -- `flags` était un troisième argument non standard disponible uniquement dans Gecko : *str*.replace(_regexp_|_substr_, _newSubStr_|_function, flags_) -- À partir de Gecko 27 {{geckoRelease(27)}}, cette méthode a été modifiée pour être conforme à la spécification ECMAScript. Lorsque `replace()` est appelée avec une expression régulière globale, la propriété {{jsxref("RegExp.lastIndex")}} (si elle est définie) sera remise à `0` ({{bug(501739)}}). -- À partir de Gecko 39 {{geckoRelease(39)}}, l'argument non-standard `flags` est désapprouvé et déclenche un avertissement dans la console ({{bug(1142351)}}). +- `flags` était un troisième argument non standard disponible uniquement dans Gecko : *str*.replace(_regexp_|_substr_, _newSubStr_|_function, flags_) +- À partir de Gecko 27 {{geckoRelease(27)}}, cette méthode a été modifiée pour être conforme à la spécification ECMAScript. Lorsque `replace()` est appelée avec une expression régulière globale, la propriété {{jsxref("RegExp.lastIndex")}} (si elle est définie) sera remise à `0` ({{bug(501739)}}). +- À partir de Gecko 39 {{geckoRelease(39)}}, l'argument non-standard `flags` est désapprouvé et déclenche un avertissement dans la console ({{bug(1142351)}}). - À partir de Gecko 47 {{geckoRelease(47)}}, l'argument non-standard `flags` n'est plus supporté dans les versions non distribution et sera bientôt retiré complètement ({{bug(1245801)}}). -- À partir de Gecko 49 {{geckoRelease(49)}}, l'argument non-standard `flags` n'est plus supporté ({{bug(1108382)}}). +- À partir de Gecko 49 {{geckoRelease(49)}}, l'argument non-standard `flags` n'est plus supporté ({{bug(1108382)}}). ## Voir aussi |