TypedArray.prototype.subarray()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die subarray()-Methode von TypedArray Instanzen gibt ein neues getyptes Array im selben ArrayBuffer-Speicher und mit den gleichen Elementtypen wie dieses getypte Array zurück. Der Startversatz ist inklusiv und der Endversatz ist exklusiv.

Probieren Sie es aus

Syntax

js
subarray()
subarray(begin)
subarray(begin, end)

Parameter

begin Optional

Element, bei dem begonnen wird. Der Versatz ist inklusiv. Das gesamte Array wird eingeschlossen, wenn dieser Wert nicht angegeben wird.

end Optional

Element, bei dem es endet. Der Versatz ist exklusiv. Wenn nicht angegeben, werden alle Elemente vom durch begin angegebenen bis zum Ende des Arrays im neuen View eingeschlossen.

Rückgabewert

Ein neues TypedArray-Objekt.

Beschreibung

Der durch begin und end angegebene Bereich wird auf den gültigen Indexbereich für das aktuelle Array beschränkt; wenn die berechnete Länge des neuen Arrays negativ wäre, wird sie auf null geklammert. Wenn entweder begin oder end negativ ist, bezieht sich dies auf einen Index vom Ende des Arrays anstelle vom Anfang.

Beachten Sie auch, dass dies eine neue Ansicht auf den bestehenden Puffer erstellt; Änderungen an den Inhalten des neuen Objekts werden das Originalobjekt und umgekehrt beeinflussen.

Beispiele

Verwendung der subarray()-Methode

js
const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer);
uint8.set([1, 2, 3]);

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

const sub = uint8.subarray(0, 4);

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

Spezifikationen

Specification
ECMAScript Language Specification
# sec-%typedarray%.prototype.subarray

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch