TypedArray.prototype.slice()

La méthode slice() renvoie une copie superficielle (shallow copy) d'un fragment du tableau typé courant dans un nouveau tableau typé. Cette méthode utilise le même algorithme que Array.prototype.slice(). TypedArray est utilisé par la suite de façon générique pour réprésenter l'un des types de tableaux typés.

Syntaxe

typedarray.slice([début[, fin]])

Paramètres

début Facultatif

L'indice (compté à partir de zéro) à partir duquel commencer le fragment.

Si l'indice fourni est négatif, début indiquera le décalage par rapport à la fin de la séquence. Par exemple, slice(-2) extrait les deux derniers éléments de la séquence.

Par défaut, si début n'est pas utilisé, slice() commencera à partir de l'indice 0.

fin Facultatif

L'indice (compté à partir de zéro) jusqu'auquel extraire le fragment. Le fragment obtenu n'incluera pas l'élément situé à l'indice fin.

slice(1,4) extrait par exemple à partir du deuxième élément et jusqu'au quatrième (c'est-à-dire les éléments dont les indices respectifs sont 1, 2, et 3).

Si l'indice utilisé est négatif, fin indiquera le décalage par rapport à la fin de la séquence. Ainsi, slice(2,-1) extraira à partir du troisième élément et jusqu'à l'avant dernier élément (compris).

Par défaut, si fin n'est pas utilisé, slice() extraira les éléments jusqu'à la fin de la séquence (arr.length).

Valeur de retour

Un nouveau tableau typé qui contient les éléments extraits.

Description

La méthode slice() ne modifie pas le tableau typé courant, elle renvoie une copie superficielle (shallow copy) du tableau typé original.

Si un nouvel élément est ajouté à l'un des deux tableaux typés, l'autre ne sera pas impacté.

Exemples

Renvoyer un fragment d'un tableau typé existant

var uint8 = new Uint8Array([1,2,3]);
uint8.slice(1);   // Uint8Array [ 2, 3 ]
uint8.slice(2);   // Uint8Array [ 3 ]
uint8.slice(-2);  // Uint8Array [ 2, 3 ]
uint8.slice(0,1); // Uint8Array [ 1 ]

Spécifications

Compatibilité des navigateurs

Voir aussi

• Array.prototype.slice()