TypedArray.prototype.subarray()

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 subarray()-Methode von TypedArray-Instanzen gibt ein neues typisiertes Array im selben ArrayBuffer-Speicher und mit den gleichen Elementtypen wie dieses typisierte Array zurück. Der Startversatz ist inklusive und der Endversatz ist exklusiv.

In diesem Artikel

Probieren Sie es aus

const uint8 = new Uint8Array([10, 20, 30, 40, 50]);

console.log(uint8.subarray(1, 3));
// Expected output: Uint8Array [20, 30]

console.log(uint8.subarray(1));
// Expected output: Uint8Array [20, 30, 40, 50]

Syntax

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

Parameter

begin Optional

Element, bei dem begonnen wird. Der Versatz ist inklusive. Das gesamte Array wird in der neuen Ansicht enthalten sein, wenn dieser Wert nicht angegeben wird.

end Optional

Element, bei dem geendet wird. Der Versatz ist exklusiv. Wenn nicht angegeben, werden alle Elemente von dem durch begin angegebenen bis zum Ende des Arrays in der neuen Ansicht enthalten sein.

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 beschränkt. Wenn entweder begin oder end negativ ist, bezieht es sich auf einen Index vom Ende des Arrays anstatt vom Anfang.

Es ist auch zu beachten, dass dies eine neue Ansicht auf den bestehenden Puffer erstellt; Änderungen am Inhalt des neuen Objekts wirken sich auf das ursprüngliche Objekt aus und umgekehrt.

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 ]

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
TypedArray
Statische Methoden
1. from()
2. of()
Statische Eigenschaften
1. BYTES_PER_ELEMENT
2. [Symbol.species]
Instanzmethoden
1. at()
2. copyWithin()
3. entries()
4. every()
5. fill()
6. filter()
7. find()
8. findIndex()
9. findLast()
10. findLastIndex()
11. forEach()
12. includes()
13. indexOf()
14. join()
15. keys()
16. lastIndexOf()
17. map()
18. reduce()
19. reduceRight()
20. reverse()
21. set()
22. slice()
23. some()
24. sort()
25. subarray()
26. toLocaleString()
27. toReversed()
28. toSorted()
29. toString()
30. values()
31. with()
32. [Symbol.iterator]()
Instanzeigenschaften
1. buffer
2. byteLength
3. byteOffset
4. length
Vererbung
Object/Function
Statische Methoden
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
Statische Eigenschaften
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
Instanzmethoden
1. __defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. hasOwnProperty()
6. isPrototypeOf()
7. propertyIsEnumerable()
8. toLocaleString()
9. toString()
10. valueOf()
Instanzeigenschaften
1. __proto__
2. constructor
Verwandte Seiten
BigInt64Array
BigUint64Array
Float16Array
Float32Array
Float64Array
Int8Array
Int16Array
Int32Array
Uint8Array
Uint8ClampedArray
Uint16Array
Uint32Array