TypedArray.prototype.set()

La méthode set() permet d'enregistrer plusieurs valeurs dans le tableau typé à partir d'un tableau donné.

Syntaxe

typedarr.set(tableau [,décalage])
typedarr.set(tableauTypé [,décalage])

Paramètres

tableau
Le tableau à partir duquel on copie les valeurs. Toutes les valeurs du tableau source seront copiées dans le tableau cible sauf si la longueur du tableau cible est trop courte en fonction du décalage défini et de la longueur du tableau source : dans ce cas, un exception sera renvoyée.
tableauTypé
Si le tableau source est un tableau typé, il se peut que les deux tableaux partagent le même ArrayBuffer ; le moteur effectuera alors une copie intelligente entre le tableau source et le tableau ciblé.
décalage Facultatif
Le décalage, exprimé en nombre d'éléments, à partir duquel copier les valeurs du tableau source dans le tableau cible. Si le paramètre n'est pas utilisé, la valeur par défaut sera 0 (ce qui correspond au cas où les éléments seront copiés au début du tableau).

Valeur de retour

undefined.

Exceptions

RangeError
Cette exception est renvoyée lorsque le décalage est tel que des valeurs seraient enregistrées en dehors du tableau typé.

Exemple

Utiliser la méthode set

var buffer = new ArrayBuffer(8);
var uint8 = new Uint8Array(buffer);

uint8.set([1,2,3], 3);

console.log(uint8); // Uint8Array [ 0, 0, 0, 1, 2, 3, 0, 0 ]

Spécifications

Spécification État Commentaires
Typed Array Specification Obsolete Englobée avec ECMAScript 6.
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'TypedArray.prototype.set' dans cette spécification.
Standard Définition initiale au sein d'un standard ECMA.
ECMAScript 2017 Draft (ECMA-262)
La définition de 'TypedArray.prototype.set' dans cette spécification.
Projet  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple 7.0 4.0 (2) 10 11.6 5.1
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple 4.0 (Oui) 4.0 (2) 10 11.6 4.2

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight
 Dernière mise à jour par : SphinxKnight,