[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/set [Back]  [Original]

TypedArray.prototype.set() - JavaScript | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

TypedArray.prototype.set()

Baseline Large disponibilit

Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La mthode set() permet d'enregistrer plusieurs valeurs dans le tableau typ partir d'un tableau donn.

Dans cet article

Exemple interactif

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer);

// Copy the values into the array starting at index 3
uint8.set([1, 2, 3], 3);

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

Syntaxe

js
typedArr.set(tableau [, dcalage])
typedArr.set(tableauTyp [, dcalage])

Paramtres

tableau

Le tableau partir duquel on copie les valeurs. Toutes les valeurs du tableau source seront copies dans le tableau cible sauf si la longueur du tableau cible est trop courte en fonction du dcalage dfini et de la longueur du tableau source : dans ce cas, un exception sera renvoye.

tableauTyp

Si le tableau source est un tableau typ, il se peut que les deux tableaux partagent le mme ArrayBuffer ; le moteur effectuera alors une copie intelligente entre le tableau source et le tableau cibl.

dcalage Facultatif

Le dcalage, exprim en nombre d'lments, partir duquel copier les valeurs du tableau source dans le tableau cible. Si le paramtre n'est pas utilis, la valeur par dfaut sera 0 (ce qui correspond au cas o les lments seront copis au dbut du tableau).

Valeur de retour

undefined.

Exceptions

RangeError

Cette exception est renvoye lorsque le dcalage est tel que des valeurs seraient enregistres en dehors du tableau typ.

Exemples

js
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 ]

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification
# sec-%typedarray%.prototype.set

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page