TypedArray.prototype.set()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die Methode set() von TypedArray-Instanzen speichert mehrere Werte in einem typisierten Array. Die Eingabewerte werden aus einem angegebenen Array gelesen.
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. Wenn die Länge des Quellarrays zuzüglich des Ziel-Offsets die Länge des Zielarrays überschreitet, wird eine Ausnahme ausgelöst.
typedarray-
Wenn das Quellarray ein typisiertes Array ist, können die beiden Arrays denselben zugrunde liegenden
ArrayBufferverwenden. Die JavaScript-Engine kopiert den Quellbereich des Puffers in den Zielbereich. targetOffsetOptional-
Der Offset im Zielarray, ab dem die Werte aus dem Quellarray geschrieben werden. Wird dieser Wert weggelassen, wird 0 angenommen. Das Quellarray überschreibt dann die Werte im Zielarray ab Index 0.
Rückgabewert
Keiner (undefined).
Ausnahmen
RangeError-
Wird in einem der folgenden Fälle ausgelöst:
- Ein Element würde über das Ende des typisierten Arrays hinaus gespeichert, weil
targetOffsetzu groß ist oder weilarrayodertypedarrayzu groß ist. targetOffsetist negativ.
- Ein Element würde über das Ende des typisierten Arrays hinaus gespeichert, weil
Beispiele
>set() verwenden
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
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification> # sec-%typedarray%.prototype.set> |