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/sharedarraybuffer/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/sharedarraybuffer/slice')
-rw-r--r-- | files/fr/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.md | 97 |
1 files changed, 41 insertions, 56 deletions
diff --git a/files/fr/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.md b/files/fr/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.md index 57219bc3f2..5f2c128fc4 100644 --- a/files/fr/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.md +++ b/files/fr/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.md @@ -12,78 +12,63 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer/slice original_slug: Web/JavaScript/Reference/Objets_globaux/SharedArrayBuffer/slice --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>SharedArrayBuffer.prototype.slice()</strong></code> renvoie un nouvel objet {{jsxref("SharedArrayBuffer")}} dont le contenu est une copie des octets de l'objet <code>SharedArrayBuffer</code> courant entre un indice de début (inclus) et un indice de fin (exclus) (autrement dit, on copie une « tranche » du tampon courant). Si l'indice de début ou de fin est négatif, la position sera comptée à partir de la fin du tableau plutôt qu'à partir du début. L'algorithme appliqué est le même que {{jsxref("Array.prototype.slice()")}}<em>.</em></p> +La méthode **`SharedArrayBuffer.prototype.slice()`** renvoie un nouvel objet {{jsxref("SharedArrayBuffer")}} dont le contenu est une copie des octets de l'objet `SharedArrayBuffer` courant entre un indice de début (inclus) et un indice de fin (exclus) (autrement dit, on copie une « tranche » du tampon courant). Si l'indice de début ou de fin est négatif, la position sera comptée à partir de la fin du tableau plutôt qu'à partir du début. L'algorithme appliqué est le même que {{jsxref("Array.prototype.slice()")}}_._ -<div>{{EmbedInteractiveExample("pages/js/sharedarraybuffer-slice.html")}}</div> +{{EmbedInteractiveExample("pages/js/sharedarraybuffer-slice.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>sab</var>.slice() -<var>sab</var>.slice(début) -<var>sab</var>.slice(début, fin)</pre> + sab.slice() + sab.slice(début) + sab.slice(début, fin) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>début</code> {{optional_inline}}</dt> - <dd> - <p>L'indice auquel commencer l'extraction (le début du tableau se situe à l'indice 0).</p> +- `début` {{optional_inline}} - <p>Si la valeur est négative, <code>début</code> indique le décalage à partir de la fin du tableau. Ainsi <code>slice(-2)</code> permettra d'extraire les deux derniers éléments du tableau.</p> + - : L'indice auquel commencer l'extraction (le début du tableau se situe à l'indice 0). - <p>Si <code>début</code> est absent, <code>slice</code> commencera l'extraction à partir de l'indice 0.</p> - </dd> - <dt><code>fin</code> {{optional_inline}}</dt> - <dd> - <p>L'indice auquel finir l'extraction. Attention, la valeur du tableau pour cet indice n'est pas incluse dans l'extraction.</p> + Si la valeur est négative, `début` indique le décalage à partir de la fin du tableau. Ainsi `slice(-2)` permettra d'extraire les deux derniers éléments du tableau. - <p>Ainsi, <code>slice(1,4)</code> permettra d'extraire entre le deuxième et le quatrième élément (c'est-à-dire les trois éléments dont les indices sont respectivement 1, 2 et 3).</p> + Si `début` est absent, `slice` commencera l'extraction à partir de l'indice 0. - <p>Si <code>fin</code> est un indice négatif, il indique le décalage à partir de la fin du tableau. Autrement dit <code>slice(2,-1)</code> permettra d'extraire les éléments du tampon à partir du troisième élément et jusqu'à l'avant-avant-dernier élément.</p> +- `fin` {{optional_inline}} - <p>Si <code>fin</code> est absent, <code>slice</code> réalisera l'extraction jusqu'à la fin de la séquence (<code>sab.byteLength</code>).</p> - </dd> -</dl> + - : L'indice auquel finir l'extraction. Attention, la valeur du tableau pour cet indice n'est pas incluse dans l'extraction. -<h3 id="Valeur_de_retour">Valeur de retour</h3> + Ainsi, `slice(1,4)` permettra d'extraire entre le deuxième et le quatrième élément (c'est-à-dire les trois éléments dont les indices sont respectivement 1, 2 et 3). -<p>Un nouvel objet {{jsxref("SharedArrayBuffer")}} qui contient les éléments extraits.</p> + Si `fin` est un indice négatif, il indique le décalage à partir de la fin du tableau. Autrement dit `slice(2,-1)` permettra d'extraire les éléments du tampon à partir du troisième élément et jusqu'à l'avant-avant-dernier élément. -<h2 id="Exemples">Exemples</h2> + Si `fin` est absent, `slice` réalisera l'extraction jusqu'à la fin de la séquence (`sab.byteLength`). -<pre class="brush:js">var sab = new SharedArrayBuffer(1024); +### Valeur de retour + +Un nouvel objet {{jsxref("SharedArrayBuffer")}} qui contient les éléments extraits. + +## Exemples + +```js +var sab = new SharedArrayBuffer(1024); sab.slice(); // SharedArrayBuffer { byteLength: 1024 } sab.slice(2); // SharedArrayBuffer { byteLength: 1022 } sab.slice(-2); // SharedArrayBuffer { byteLength: 2 } sab.slice(0,1); // SharedArrayBuffer { byteLength: 1 } -</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-sharedarraybuffer.prototype.slice', 'SharedArrayBuffer.prototype.slice')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td>Définition initiale avec ES2017.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.SharedArrayBuffer.slice")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("SharedArrayBuffer")}}</li> - <li>{{jsxref("Array.prototype.slice()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------------------- | +| {{SpecName('ESDraft', '#sec-sharedarraybuffer.prototype.slice', 'SharedArrayBuffer.prototype.slice')}} | {{Spec2('ESDraft')}} | Définition initiale avec ES2017. | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.SharedArrayBuffer.slice")}} + +## Voir aussi + +- {{jsxref("SharedArrayBuffer")}} +- {{jsxref("Array.prototype.slice()")}} |