TypedArray.prototype.copyWithin()
La méthode copyWithin()
permet de copier des éléments d'un tableau dans le tableau typé à partir de la position cible
. Les éléments copiés sont ceux contenus entre les index début
et fin
. L'argument fin
est optionnel, sa valeur par défaut correspondra à la longueur du tableau dont on souhaite copier les éléments. Cette méthode utilise le même algorithme que Array.prototype.copyWithin
. TypedArray est l'un des types de tableaux typés.
Exemple interactif
Syntaxe
js
typedarray.copyWithin(cible, début[, fin = this.length])
Paramètres
cible
-
La position, dans le tableau typé, à partir de laquelle on souhaite copier les éléments.
début
-
La position du tableau contenant les éléments à copier à partir de laquelle copier les éléments.
fin Facultatif
-
Paramètre optionnel. La position jusqu'à laquelle prendre les éléments à copier.
Valeur de retour
Le tableau typé, modifié par la fonction.
Description
Voir la page Array.prototype.copyWithin
pour plus d'informations.
Cette méthode remplace la méthode expérimentale TypedArray.prototype.move()
.
Exemples
js
var buffer = new ArrayBuffer(8);
var uint8 = new Uint8Array(buffer);
uint8.set([1, 2, 3]);
console.log(uint8); // Uint8Array [ 1, 2, 3, 0, 0, 0, 0, 0 ]
uint8.copyWithin(3, 0, 3);
console.log(uint8); // Uint8Array [ 1, 2, 3, 1, 2, 3, 0, 0 ]
Spécifications
Specification |
---|
ECMAScript Language Specification # sec-%typedarray%.prototype.copywithin |
Compatibilité des navigateurs
BCD tables only load in the browser