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
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
Étiquettes :
Contributeurs à cette page :
SphinxKnight
Dernière mise à jour par :
SphinxKnight,