Int8Array

Das Int8Array getypte Array repr├Ąsentiert ein Array von zweierkomplement 8 Bit vorzeichenbehafteten, ganze Zahlen in der Plattform-Byte-Reihenfolge. 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 Int8Array(); // new in ES2017
new Int8Array(length);
new Int8Array(typedArray);
new Int8Array(object);
new Int8Array(buffer [, byteOffset [, length]]);

F├╝r mehr Informationen ├╝ber die Konstruktorensyntax und die Parameter, siehe auf der Seite TypedArray.

Eigenschaften

Int8Array.BYTES_PER_ELEMENT
Gibt die Gr├Â├če der Elemente zur├╝ck. 1 im Falle eines Int8rray.
Int8Array.length
Statische L├Ąngeneigenschaft welche den Wert 0 hat. F├╝r die aktuelle L├Ąnge (Anzahl der Elemente) siehe Int8Array.prototype.length.
Int8Array.name
Gibt den Stringwert des Konstruktornamens zur├╝ck. In Fall eines Int8Array Typs: "Int8Array".
Int8Array.prototype
Prototyp f├╝r das TypedArray Objekt.

Methoden

Int8Array.from()
Erstelle ein neues Int8Array von einem Array-Ähnlichen oder Iterable Objekt. Siehe auch Array.from().
Int8Array.of()
Erstellt ein neues Int8Array mit einer variablen Anzahl an Argumenten. Sie auch Array.of().

Int8Array Prototyp

 

Alle Int8Array Objekte erben von %TypedArray%.prototype.

Eigenschaften

Int8Array.prototype.constructor
Gibt die Funktion, die einen Instanzprototyp erstellt zur├╝ck. Diese ist auf den Int8Array Konstruktor voreingestellt.
Int8Array.prototype.buffer Schreibgesch├╝tzt
Gibt die ArrayBuffer Referenz zur├╝ck, welche nach der Erstellung eines Int8Array fest ist und nicht mehr ge├Ąndert werden kann.
Int8Array.prototype.byteLength Schreibgesch├╝tzt
Gibt die L├Ąnge (in Bytes) des Int8Array vom Anfang seines ArrayBuffer zur├╝ck. WIrd beim erstellen festgesetzt und kann nicht ge├Ąndert werden.
Int8Array.prototype.byteOffset Schreibgesch├╝tzt
Gibt das Offset (in Bytes) des Int8Array vom Anfang seines ArrayBuffer zur├╝ck. WIrd beim erstellen festgesetzt und kann nicht ge├Ąndert werden.
Int8Array.prototype.length Schreibgesch├╝tzt
Gibt Anzahl der Elemente des Int8Array zur├╝ck. WIrd beim erstellen festgesetzt und kann nicht ge├Ąndert werden.

Methoden

Int8Array.prototype.copyWithin()
Kopiert eine Sequenz von Arrayelementen in das Array. Siehe auch Array.prototype.copyWithin().
Int8Array.prototype.entries()
Gibt ein neues Array Iterator Objekt zur├╝ck, welches die Schl├╝ssel/Wertepaare f├╝r jeden Index im Array enth├Ąlt. Siehe auch Array.prototype.entries().
Int8Array.prototype.every()
Teste, ob alle Elemente einem, als Funktion ├╝bergebenen, Test erf├╝llen. Siehe auch Array.prototype.every()")}}.
Int8Array.prototype.fill()
F├╝llt alle Elemente eines Arrays vom Startindex bis zum Endindex mit einem statischen Wert. Siehe auch Array.prototype.fill().
Int8Array.prototype.filter()
Erstellt ein neues Array mit allen Elementen des alten Arrays, f├╝r die eine ├╝bergebene Filterfunktion true zur├╝ckgibt. Siehe auch Array.prototype.filter().
Int8Array.prototype.find()
Gibt ein gefundenes Element des Arrays zur├╝ck, welches bei der ├╝bergebenen Testfunktion true zur├╝ckgibt oder undefined wenn es keins gibt. Siehe auch Array.prototype.find().
Int8Array.prototype.findIndex()
Gibt den Index eines gefundenen Elements des Arrays zur├╝ck, welches bei der ├╝bergebenen Testfunktion true zur├╝ckgibt oder -1 wenn es keins gibt. Siehe auch Array.prototype.findIndex().
Int8Array.prototype.forEach()
Ruft f├╝r jedes Element in einem Array eine Funktion auf. Siehe auch Array.prototype.forEach().
Int8Array.prototype.includes()
├ťberpr├╝ft, ob ein getyptes Array ein bestimmtes Element enth├Ąlt und gibt gegebenfalls true oderfalse zur├╝ck. Siehe auch Array.prototype.includes().
Int8Array.prototype.indexOf()
Gibt den ersten Index eines Elementes zur├╝ck, welches gleiche eines spezifizierten Wertes ist oder -1 wenn es keins gibt. Siehe auch Array.prototype.indexOf().
Int8Array.prototype.join()
F├╝hrt alle Elemente eines Arrays zu einem String zusammen. Siehe auch Array.prototype.join().
Int8Array.prototype.keys()
Gibt ein neuen Array Iterator zur├╝ck, der alle Schl├╝ssel f├╝r jeden Index im Array enth├Ąlt. Siehe auch Array.prototype.keys().
Int8Array.prototype.lastIndexOf()
Gibt den letzen Index eines Elementes zur├╝ck, welches gleiche eines spezifizierten Wertes ist oder -1 wenn es keins gibt. Siehe auch Array.prototype.lastIndexOf().
Int8Array.prototype.map()
Erstellt ein neues Array mit den Resultaten spezifizierten Funktion, die f├╝r jedes Element aufgerufen wird. Siehe auch Array.prototype.map().
Int8Array.prototype.move() Nicht implementiert
Ehemalige nicht Standardisierte Version von Int8Array.prototype.copyWithin().
Int8Array.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().
Int8Array.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().
Int8Array.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().
Int8Array.prototype.set()
Speichert mehrere Werte in einem getypten Array und lie├čt Eingabewerte aus einem spezifiziertem Array.
Int8Array.prototype.slice()
Extrahiert einen Bereich aus einem Array und gibt diesen in einem neuen Array zur├╝ck. Siehe auch Array.prototype.slice().
Int8Array.prototype.some()
Gibt true zur├╝ck, wenn nur ein Element in einem Array den als Funktion ├╝bergebenen Test erf├╝llt. Siehe auch Array.prototype.some()
Int8Array.prototype.sort()
Sortiert die Elemente eines Arrays in-Place und gibt das Array zur├╝ck. Siehe auch Array.prototype.sort().
Int8Array.prototype.subarray()
Gibt ein neues Int8Array vom gegebenen Start- und Endindex zur├╝ck.
Int8Array.prototype.values()
Gibt ein neues Array Iterator Objekt zur├╝ck, welches die Werte von jedem Index im Array enth├Ąlt. Siehe auch Array.prototype.values().
Int8Array.prototype.toLocaleString()
Gibt einen Ortsabh├Ąngige Stringrepr├Ąsentation des Arrays und seiner Element zur├╝ck. Siehe auch Array.prototype.toLocaleString().
Int8Array.prototype.toString()
Gibt einen Stringrepr├Ąsentation des Arrays und seiner Element zur├╝ck. Siehe auch Array.prototype.toString().
Int8Array.prototype[@@iterator]()
Gibt ein neues Array Iterator Objekt zur├╝ck, welches die zugeh├Ârigen Werte f├╝r jeden Index im Array enthalten.

 

Beispiele

Verschiedene Wege, um ein Int8Array zu erstellen:

// From a length
var int8 = new Int8Array(2);
int8[0] = 42;
console.log(int8[0]); // 42
console.log(int8.length); // 2
console.log(int8.BYTES_PER_ELEMENT); // 1

// From an array
var arr = new Int8Array([21,31]);
console.log(arr[1]); // 31

// From another TypedArray
var x = new Int8Array([21, 31]);
var y = new Int8Array(x);
console.log(y[0]); // 21

// From an ArrayBuffer
var buffer = new ArrayBuffer(8);
var z = new Int8Array(buffer, 1, 4);

// From an iterable
var iterable = function*(){ yield* [1,2,3]; }();
var int8 = new Int8Array(iterable);
// Int8Array[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 (ECMA-262)
Die Definition von 'TypedArray constructors' in dieser Spezifikation.
Lebender Standard ECMAScript 2017 ├Ąndert den Int8Array Konstruktor, um die ToIndex Operation zu benutzen und erlaubt einen Konstruktor ohne Parameter.

Browserkompatibilit├Ąt

BCD tables only load in the browser

Kompatibilit├Ątshinweise

Mit Beginn von ECMAScript 2015, m├╝ssen Int8Array Konstruktoren mit einem new benutzt werden. Der Aufruf eines Int8Array Konstruktors als eine Funktion ohne new, F├╝hrt jetzt zu einem TypeError.

var dv = Int8Array([1, 2, 3]);
// TypeError: calling a builtin Int8Array constructor
// without new is forbidden
var dv = new Int8Array([1, 2, 3]);

Siehe auch