TypedArray.prototype.set()

Probieren Sie es aus

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

Syntax

set(array)
set(array, targetOffset)

set(typedarray)
set(typedarray, targetOffset)

Parameter

array

Das Array, aus dem Werte kopiert werden. Alle Werte aus dem Quellarray werden in das Zielarray kopiert, es sei denn, die Lnge des Quellarrays plus der Zieloffset berschreitet die Lnge des Zielarrays, in diesem Fall wird eine Ausnahme ausgelst.

typedarray

Wenn das Quellarray ein typisiertes Array ist, knnen die beiden Arrays den gleichen zugrunde liegenden ArrayBuffer teilen; die JavaScript-Engine kopiert intelligent den Quellbereich des Puffers in den Zielbereich.

targetOffset Optional

Der Offset im Zielarray, bei dem mit dem Schreiben von Werten aus dem Quellarray begonnen werden soll. Wenn dieser Wert weggelassen wird, wird 0 angenommen (das heit, das Quellarray berschreibt Werte im Zielarray beginnend bei Index 0).

Rckgabewert

Keiner (undefined).

Ausnahmen

RangeError

Wird in einem der folgenden Flle ausgelst:

• Ein Element wird ber das Ende des typisierten Arrays hinaus gespeichert, entweder weil targetOffset zu gro ist oder weil array oder typedarray zu gro ist.
• targetOffset ist negativ.

Beispiele

Verwendung von set()

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

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

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

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Polyfill von TypedArray.prototype.set in core-js
• JavaScript typisierte Arrays Leitfaden
• TypedArray
• ArrayBuffer