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.

Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !

Syntaxe

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().

Exemple

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

Compatibilité des navigateurs

Voir aussi

• TypedArray