Das Int32Array getypte Array repräsentiert ein Array von zweierkomplement 32 Bit vorzeichenbehafteten, ganze Zahlen in der Plattform-Byte-Reihenfolge. Wenn Kontrolle über die Byte-Reihenfolge erforderlich ist, muss DataView stattdessen benutz werden. Die Inhalte werden mit 0 initialisiert. Wie erwartet, kann man Element in einem Array mit Objektmethoden referenzieren oder man benutzt die normale Arrayindex-Syntax (das ist die Klammernotation).
Syntax
new Int32Array(); // new in ES2017 new Int32Array(length); new Int32Array(typedArray); new Int32Array(object); new Int32Array(buffer [, byteOffset [, length]]);
Für mehr Informationen über die Konstruktorensyntax und die Parameter, siehe auf der Seite TypedArray.
Eigenschaften
Int32Array.BYTES_PER_ELEMENT- Gibt die Größe der Elemente zurück.
4im Falle einesInt32Array. - Int32Array.length
- Statische Längeneigenschaft welche den Wert 0 hat. Für die aktuelle Länge (Anzahl der Elemente) siehe
Int32Array.prototype.length. Int32Array.name- Gibt den Stringwert des Konstruktornamens zurück. In Fall eines
Int32ArrayTyps:"Int32Array". Int32Array.prototype- Prototyp für das TypedArray Objekt.
Methoden
Int32Array.from()- Erstelle ein neues
Int32Arrayvon einem Array-Ähnlichen oder Iterable Objekt. Siehe auchArray.from(). Int32Array.of()- Erstellt ein neues
Int32Arraymit einer variablen Anzahl an Argumenten. Sie auchArray.of().
Int32Array Prototyp
Alle Int32Array Objekte erben von %TypedArray%.prototype.
Eigenschaften
Int32Array.prototype.constructor- Gibt die Funktion, die einen Instanzprototyp erstellt zurück. Diese ist auf den
Int32ArrayKonstruktor voreingestellt. Int32Array.prototype.bufferSchreibgeschützt- Gibt die
ArrayBufferReferenz zurück, welche nach der Erstellung einesInt32Arrayfest ist und nicht mehr geändert werden kann. Int32Array.prototype.byteLengthSchreibgeschützt- Gibt die Länge (in Bytes) des
Int32Arrayvom Anfang seinesArrayBufferzurück. WIrd beim erstellen festgesetzt und kann nicht geändert werden. Int32Array.prototype.byteOffsetSchreibgeschützt- Gibt das Offset (in Bytes) des
Int32Arrayvom Anfang seinesArrayBufferzurück. WIrd beim erstellen festgesetzt und kann nicht geändert werden. Int32Array.prototype.lengthSchreibgeschützt- Gibt Anzahl der Elemente des
Int32Arrayzurück. WIrd beim erstellen festgesetzt und kann nicht geändert werden.
Methoden
Int32Array.prototype.copyWithin()- Kopiert eine Sequenz von Arrayelementen in das Array. Siehe auch
Array.prototype.copyWithin(). Int32Array.prototype.entries()- Gibt ein neues
Array IteratorObjekt zurück, welches die Schlüssel/Wertepaare für jeden Index im Array enthält. Siehe auchArray.prototype.entries(). Int32Array.prototype.every()- Teste, ob alle Elemente einem, als Funktion übergebenen, Test erfüllen. Siehe auch Array.prototype.every()")}}.
Int32Array.prototype.fill()- Füllt alle Elemente eines Arrays vom Startindex bis zum Endindex mit einem statischen Wert. Siehe auch
Array.prototype.fill(). Int32Array.prototype.filter()- Erstellt ein neues Array mit allen Elementen des alten Arrays, für die eine übergebene Filterfunktion
truezurückgibt. Siehe auchArray.prototype.filter(). Int32Array.prototype.find()- Gibt ein gefundenes Element des Arrays zurück, welches bei der übergebenen Testfunktion
truezurückgibt oderundefinedwenn es keins gibt. Siehe auchArray.prototype.find(). Int32Array.prototype.findIndex()- Gibt den Index eines gefundenen Elements des Arrays zurück, welches bei der übergebenen Testfunktion
truezurückgibt oder-1wenn es keins gibt. Siehe auchArray.prototype.findIndex(). Int32Array.prototype.forEach()- Ruft für jedes Element in einem Array eine Funktion auf. Siehe auch
Array.prototype.forEach(). Int32Array.prototype.includes()- Überprüft, ob ein getyptes Array ein bestimmtes Element enthält und gibt gegebenfalls
trueoderfalsezurück. Siehe auchArray.prototype.includes(). Int32Array.prototype.indexOf()- Gibt den ersten Index eines Elementes zurück, welches gleiche eines spezifizierten Wertes ist oder
-1wenn es keins gibt. Siehe auchArray.prototype.indexOf(). Int32Array.prototype.join()- Führt alle Elemente eines Arrays zu einem String zusammen. Siehe auch
Array.prototype.join(). Int32Array.prototype.keys()- Gibt ein neuen
Array Iteratorzurück, der alle Schlüssel für jeden Index im Array enthält. Siehe auchArray.prototype.keys(). Int32Array.prototype.lastIndexOf()- Gibt den letzen Index eines Elementes zurück, welches gleiche eines spezifizierten Wertes ist oder
-1wenn es keins gibt. Siehe auchArray.prototype.lastIndexOf(). Int32Array.prototype.map()- Erstellt ein neues Array mit den Resultaten spezifizierten Funktion, die für jedes Element aufgerufen wird. Siehe auch
Array.prototype.map(). Int32Array.prototype.move()Nicht implementiert- Ehemalige nicht Standardisierte Version von
Int32Array.prototype.copyWithin(). Int32Array.prototype.reduce()- Führt eine Funktion gegeben einen Akkumulator und jeden Wert des Array aus (von links nach rechts), um das Array auf einen Wert zu reduzieren. Siehe auch
Array.prototype.reduce(). Int32Array.prototype.reduceRight()- Führt eine Funktion gegeben einen Akkumulator und jeden Wert des Array aus (von rechts nach links), um das Array auf einen Wert zu reduzieren. Siehe auch
Array.prototype.reduce(). Int32Array.prototype.reverse()- Kehrt die Reihenfolge von jedem Element eines Arrays um — das Erste wird das Letzte und das Letzte wird das Erste. Siehe auch
Array.prototype.reverse(). Int32Array.prototype.set()- Speichert mehrere Werte in einem getypten Array und ließt Eingabewerte aus einem spezifiziertem Array.
Int32Array.prototype.slice()- Extrahiert einen Bereich aus einem Array und gibt diesen in einem neuen Array zurück. Siehe auch
Array.prototype.slice(). Int32Array.prototype.some()- Gibt
truezurück, wenn nur ein Element in einem Array den als Funktion übergebenen Test erfüllt. Siehe auchArray.prototype.some() Int32Array.prototype.sort()- Sortiert die Elemente eines Arrays in-Place und gibt das Array zurück. Siehe auch
Array.prototype.sort(). Int32Array.prototype.subarray()- Gibt ein neues
Int32Arrayvom gegebenen Start- und Endindex zurück. Int32Array.prototype.values()- Gibt ein neues
Array IteratorObjekt zurück, welches die Werte von jedem Index im Array enthält. Siehe auchArray.prototype.values(). Int32Array.prototype.toLocaleString()- Gibt einen Ortsabhängige Stringrepräsentation des Arrays und seiner Element zurück. Siehe auch
Array.prototype.toLocaleString(). Int32Array.prototype.toString()- Gibt einen Stringrepräsentation des Arrays und seiner Element zurück. Siehe auch
Array.prototype.toString(). Int32Array.prototype[@@iterator]()- Gibt ein neues
Array IteratorObjekt zurück, welches die zugehörigen Werte für jeden Index im Array enthalten.
Beispiele
Verschiedene Wege, um ein Int32Array zu erstellen:
// From a length
var int32 = new Int32Array(2);
int32[0] = 42;
console.log(int32[0]); // 42
console.log(int32.length); // 2
console.log(int32.BYTES_PER_ELEMENT); // 4
// From an array
var arr = new Int32Array([21,31]);
console.log(arr[1]); // 31
// From another TypedArray
var x = new Int32Array([21, 31]);
var y = new Int32Array(x);
console.log(y[0]); // 21
// From an ArrayBuffer
var buffer = new ArrayBuffer(16);
var z = new Int32Array(buffer, 0, 4);
// From an iterable
var iterable = function*(){ yield* [1,2,3]; }();
var int32 = new Int32Array(iterable);
// Int32Array[1, 2, 3]
Spezifikationen
| Spezifikation | Status | Kommentar |
|---|---|---|
| Typed Array Specification | Veraltet | Ersetzt in ECMAScript 2015. |
| ECMAScript 2015 (6th Edition, ECMA-262) Die Definition von 'TypedArray constructors' in dieser Spezifikation. |
Standard | Initiale Definition in einem ECMA Standard. Spezifiziert, dass ein new benötigt wird. |
| ECMAScript Latest Draft (ECMA-262) Die Definition von 'TypedArray constructors' in dieser Spezifikation. |
Entwurf | ECMAScript 2017 ändert den Int32Array Konstruktor, um die ToIndex Operation zu benutzen und erlaubt einen Konstruktor ohne Parameter. |
Browserkompatibilität
| Desktop | Mobile | Server | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Int32Array | Chrome Vollständige Unterstützung 7 | Edge Vollständige Unterstützung 12 | Firefox Vollständige Unterstützung 4 | IE Vollständige Unterstützung 10 | Opera Vollständige Unterstützung 11.6 | Safari Vollständige Unterstützung 5.1 | WebView Android Vollständige Unterstützung 4 | Chrome Android Vollständige Unterstützung 18 | Firefox Android Vollständige Unterstützung 4 | Opera Android Vollständige Unterstützung 12 | Safari iOS Vollständige Unterstützung 4.2 | Samsung Internet Android Vollständige Unterstützung Ja | nodejs Vollständige Unterstützung 0.10 |
| Constructor without arguments | Chrome Vollständige Unterstützung 7 | Edge Vollständige Unterstützung 12 | Firefox Vollständige Unterstützung 55 | IE Vollständige Unterstützung 10 | Opera Vollständige Unterstützung Ja | Safari Vollständige Unterstützung 5.1 | WebView Android Vollständige Unterstützung ≤37 | Chrome Android Vollständige Unterstützung 18 | Firefox Android Vollständige Unterstützung 55 | Opera Android Vollständige Unterstützung Ja | Safari iOS Vollständige Unterstützung 5 | Samsung Internet Android Vollständige Unterstützung 1.0 | nodejs ? |
| Iterable in constructor | Chrome Vollständige Unterstützung 39 | Edge Vollständige Unterstützung 14 | Firefox Vollständige Unterstützung 52 | IE Keine Unterstützung Nein | Opera Vollständige Unterstützung 26 | Safari ? | WebView Android Vollständige Unterstützung 39 | Chrome Android Vollständige Unterstützung 39 | Firefox Android Vollständige Unterstützung 52 | Opera Android Vollständige Unterstützung 26 | Safari iOS ? | Samsung Internet Android Vollständige Unterstützung 4.0 | nodejs Vollständige Unterstützung 4.0.0 |
Int32Array() without new throws | Chrome Vollständige Unterstützung 7 | Edge Vollständige Unterstützung 14 | Firefox Vollständige Unterstützung 44 | IE Keine Unterstützung Nein | Opera Vollständige Unterstützung Ja | Safari Vollständige Unterstützung 5.1 | WebView Android Vollständige Unterstützung ≤37 | Chrome Android Vollständige Unterstützung 18 | Firefox Android Vollständige Unterstützung 44 | Opera Android Vollständige Unterstützung Ja | Safari iOS Vollständige Unterstützung 5 | Samsung Internet Android Vollständige Unterstützung 1.0 | nodejs Vollständige Unterstützung 0.12 |
Legende
- Vollständige Unterstützung
- Vollständige Unterstützung
- Keine Unterstützung
- Keine Unterstützung
- Kompatibilität unbekannt
- Kompatibilität unbekannt
Kompatibilitätshinweise
Mit Beginn von ECMAScript 2015, müssen Int32Array Konstruktoren mit einem new benutzt werden. Der Aufruf eines Int32Array Konstruktors als eine Funktion ohne new, Führt jetzt zu einem TypeError.
var dv = Int32Array([1, 2, 3]); // TypeError: calling a builtin Int32Array constructor // without new is forbidden
var dv = new Int32Array([1, 2, 3]);