diff options
author | julieng <julien.gattelier@gmail.com> | 2021-08-03 08:03:23 +0200 |
---|---|---|
committer | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-09-03 08:08:25 +0200 |
commit | bf8e099b9c8b3c60d60b3712b4fc97b052c39887 (patch) | |
tree | c101746d082c9581c94f5937519c7d0e2f4af8cb /files/fr/web/javascript/reference/global_objects/string/slice | |
parent | 844f5103992238c0c23203286dad16a466e89c97 (diff) | |
download | translated-content-bf8e099b9c8b3c60d60b3712b4fc97b052c39887.tar.gz translated-content-bf8e099b9c8b3c60d60b3712b4fc97b052c39887.tar.bz2 translated-content-bf8e099b9c8b3c60d60b3712b4fc97b052c39887.zip |
convert content to md
Diffstat (limited to 'files/fr/web/javascript/reference/global_objects/string/slice')
-rw-r--r-- | files/fr/web/javascript/reference/global_objects/string/slice/index.md | 164 |
1 files changed, 72 insertions, 92 deletions
diff --git a/files/fr/web/javascript/reference/global_objects/string/slice/index.md b/files/fr/web/javascript/reference/global_objects/string/slice/index.md index a43faa2bd1..5360b4ab0e 100644 --- a/files/fr/web/javascript/reference/global_objects/string/slice/index.md +++ b/files/fr/web/javascript/reference/global_objects/string/slice/index.md @@ -10,117 +10,97 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/String/slice original_slug: Web/JavaScript/Reference/Objets_globaux/String/slice --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>slice()</strong></code> extrait une section d'une chaine de caractères et la retourne comme une nouvelle chaine de caractères. La chaîne de caractères courante n'est pas modifiée.</p> +La méthode **`slice()`** extrait une section d'une chaine de caractères et la retourne comme une nouvelle chaine de caractères. La chaîne de caractères courante n'est pas modifiée. -<div>{{EmbedInteractiveExample("pages/js/string-slice.html")}}</div> +{{EmbedInteractiveExample("pages/js/string-slice.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>chn</em>.slice(<em>indiceDe<var>but</var></em>[, <em>indiceF</em><var><em>in</em></var>])</pre> + chn.slice(indiceDebut[, indiceFin]) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>indiceDebut</code></dt> - <dd>L'indice base 0 auquel commencer l'extraction. Si négatif, il est traité comme (<code>longueurSource + indiceDebut</code>) où <code>longueurSource</code> est la longueur de la chaine de caractères (par exemple, si <code>indiceDebut</code> est -3, il sera traité comme <code>longueurSource - 3</code>). Si <code>indiceDebut</code> est supérieur à la longueur de la chaîne, <code>slice()</code> renvoie une chaîne vide.</dd> - <dt><code>indiceFin</code></dt> - <dd>Paramètre optionnel. Un indice base 0 <em>avant</em> lequel terminer l'extraction. Le caractère à cet indice ne sera pas inclus. Si <code>indiceFin</code> est absent, <code>slice()</code> extraira jusqu'à la fin de la chaine de caractères. Si négatif, il sera traité comme (<code>longueurSource + indiceFin</code>) où <code>longueurSource</code> est la longueur de la chaine de caractères (par exemple s'il vaut <code>-3</code>, il sera traité comme <code>longueurSource - 3</code>)</dd> -</dl> +- `indiceDebut` + - : L'indice base 0 auquel commencer l'extraction. Si négatif, il est traité comme (`longueurSource + indiceDebut`) où `longueurSource` est la longueur de la chaine de caractères (par exemple, si `indiceDebut` est -3, il sera traité comme `longueurSource - 3`). Si `indiceDebut` est supérieur à la longueur de la chaîne, `slice()` renvoie une chaîne vide. +- `indiceFin` + - : Paramètre optionnel. Un indice base 0 _avant_ lequel terminer l'extraction. Le caractère à cet indice ne sera pas inclus. Si `indiceFin` est absent, `slice()` extraira jusqu'à la fin de la chaine de caractères. Si négatif, il sera traité comme (`longueurSource + indiceFin`) où `longueurSource` est la longueur de la chaine de caractères (par exemple s'il vaut `-3`, il sera traité comme `longueurSource - 3`) -<h3 id="Valeur_retournée">Valeur retournée</h3> +### Valeur retournée -<p>Une nouvelle chaîne de caractères contenant la section extraite de la chaîne.</p> +Une nouvelle chaîne de caractères contenant la section extraite de la chaîne. -<h2 id="Description">Description</h2> +## Description -<p><code>slice()</code> extrait le texte d'une chaine de caractères et retourne une nouvelle chaîne de caractères. Les changements au texte dans une chaine de caractères n'affectent pas l'autre chaîne.</p> +`slice()` extrait le texte d'une chaine de caractères et retourne une nouvelle chaîne de caractères. Les changements au texte dans une chaine de caractères n'affectent pas l'autre chaîne. -<p><code>slice()</code> extrait jusqu'à <code>indiceFin</code>, mais sans l'inclure. Par exemple, <code>chn.slice(1, 4)</code> extrait du second caractère jusqu'au quatrième caractère (caractères d'indices 1, 2 et 3).</p> +`slice()` extrait jusqu'à `indiceFin`, mais sans l'inclure. Par exemple, `chn.slice(1, 4)` extrait du second caractère jusqu'au quatrième caractère (caractères d'indices 1, 2 et 3). -<p>Par exemple, <code>chn.slice(2, -1)</code> extrait du troisième caractère jusqu'à l'avant-dernier caractère de la chaine de caractères.</p> +Par exemple, `chn.slice(2, -1)` extrait du troisième caractère jusqu'à l'avant-dernier caractère de la chaine de caractères. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utilisation_de_slice()_pour_créer_une_nouvelle_chaîne_de_caractères">Utilisation de <code>slice()</code> pour créer une nouvelle chaîne de caractères</h3> +### Utilisation de `slice()` pour créer une nouvelle chaîne de caractères -<p>L'exemple suivant utilise <code>slice()</code> pour créer une nouvelle chaîne de caractères.</p> +L'exemple suivant utilise `slice()` pour créer une nouvelle chaîne de caractères. -<pre class="brush: js">var chn1 = 'Le matin est sur nous.', // la longueur de chn1 est de 22 -<code> </code>chn<code>2 = </code>chn<code>1.slice(1, 8), - </code>chn<code>3 = </code>chn<code>1.slice(3, -2), - </code>chn<code>4 = </code>chn<code>1.slice(13), - </code>chn<code>5 = </code>chn<code>1.slice(30); -console.log(</code>chn<code>2); // SORTIE : </code>e matin<code> -console.log(</code>chn<code>3); // SORTIE : m</code>atin est sur nou<code> -console.log(</code>chn<code>4); // SORTIE : </code>sur nous.<code> -console.log(</code>chn<code>5); // SORTIE : ""</code></pre> +```js +var chn1 = 'Le matin est sur nous.', // la longueur de chn1 est de 22 + chn2 = chn1.slice(1, 8), + chn3 = chn1.slice(3, -2), + chn4 = chn1.slice(13), + chn5 = chn1.slice(30); +console.log(chn2); // SORTIE : e matin +console.log(chn3); // SORTIE : matin est sur nou +console.log(chn4); // SORTIE : sur nous. +console.log(chn5); // SORTIE : "" +``` -<h3 id="Utilisation_de_slice()_avec_des_indices_négatifs">Utilisation de <code>slice()</code> avec des indices négatifs</h3> +### Utilisation de `slice()` avec des indices négatifs -<p>L'exemple suivant utilise <code>slice()</code> avec des indices négatifs.</p> +L'exemple suivant utilise `slice()` avec des indices négatifs. -<pre class="brush:js">var chn = 'Le matin est sur nous.'; +```js +var chn = 'Le matin est sur nous.'; chn.slice(-3); // retourne "us." chn.slice(-3, -1); // retourne "us" chn.slice(0, -1); // retourne "Le matin est sur nous" -</pre> - -<p>Dans l'exemple qui suit, on commence à chercher l'indice de début à partir de la fin de la chaîne avec l'argument <code>-11</code> et on utilise un indice de fin positif avec <code>16</code> :</p> - -<pre class="brush: js">console.log(chn.slice(-11, 16)); // "st sur"</pre> - -<p>On utilise ensuite un indice de début positif (la recherche est effectuée depuis le début de la chaîne) et un indice de fin négatif pour parvenir au même résultat :</p> - -<pre class="brush: js">console.log(chn.slice(10, -5)); // "st sur"</pre> - -<p>Enfin, on utilise deux indices négatifs : la position de début et la position de fin sont recherchées à parti de la fin de la chaîne :</p> - -<pre class="brush: js">console.log(chn.slice(-11, -5)); // "st sur"</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('ES3')}}</td> - <td>{{Spec2('ES3')}}</td> - <td>Définition initiale. Implémentée dans JavaScript 1.2.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.5.4.13', 'String.prototype.slice')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-string.prototype.slice', 'String.prototype.slice')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-string.prototype.slice', 'String.prototype.slice')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.String.slice")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("String.prototype.substr()")}} {{deprecated_inline}}</li> - <li>{{jsxref("String.prototype.substring()")}}</li> - <li>{{jsxref("Array.prototype.slice()")}}</li> -</ul> +``` + +Dans l'exemple qui suit, on commence à chercher l'indice de début à partir de la fin de la chaîne avec l'argument `-11` et on utilise un indice de fin positif avec `16` : + +```js +console.log(chn.slice(-11, 16)); // "st sur" +``` + +On utilise ensuite un indice de début positif (la recherche est effectuée depuis le début de la chaîne) et un indice de fin négatif pour parvenir au même résultat : + +```js +console.log(chn.slice(10, -5)); // "st sur" +``` + +Enfin, on utilise deux indices négatifs : la position de début et la position de fin sont recherchées à parti de la fin de la chaîne : + +```js +console.log(chn.slice(-11, -5)); // "st sur" +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------ | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES3')}} | {{Spec2('ES3')}} | Définition initiale. Implémentée dans JavaScript 1.2. | +| {{SpecName('ES5.1', '#sec-15.5.4.13', 'String.prototype.slice')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-string.prototype.slice', 'String.prototype.slice')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-string.prototype.slice', 'String.prototype.slice')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.String.slice")}} + +## Voir aussi + +- {{jsxref("String.prototype.substr()")}} {{deprecated_inline}} +- {{jsxref("String.prototype.substring()")}} +- {{jsxref("Array.prototype.slice()")}} |