DataView

Die DataView Ansicht unterstützt eine Low-Level Schnittstelle für das Lesen und Schreiben von mehrere Zahlentypen in einem ArrayBuffer. Diese Ansicht ist unabhängig von den Plattform Byte-Reihenfolgen.

Syntax

new DataView(buffer [, byteOffset [, byteLength]])

Parameter

buffer

Ein existierender ArrayBuffer, der als Speicher für das neue DataView Objekt dient.

byteOffset Optional

Das Offset in Bytes, welches auf das erste Byte in dem spezifizierten Buffer für die neue Ansicht referenziert. Wenn dieser Parameter nicht angegeben ist, wird das erste Byte des Buffers als Startpunkt benutzt.

byteLength Optional

Die Anzahl der Elemente in dem Byte Array. Wenn es nicht angegeben wird, wird die Länge des Buffers benutzt.

Rückgabewert

Ein neues DataView Objekt welches den spezifizierten Datenpuffer (Buffer) repräsentiert.

Auftretende Errors

RangeError

Wird erzeugt, wenn byteOffset oder byteLength Größe als der Puffer (Buffers) sind

Beschreibung

Byte-Reihenfolge

Zahlenformate mit mehreren Bytes werden im Speicher verschieden dargestellt, je nachdem welche Maschinenarchitektur genutzt wird (siehe Endianness für weitere Erklärungen). DataView bietet explizit die Kontrolle über den Zugriff auf die Zahlen unabhängig von der Plattformarchitektur-Byte-Reihenfolge.

var littleEndian = (function() {
  var buffer = new ArrayBuffer(2);
  new DataView(buffer).setInt16(0, 256, true /* littleEndian */);
  // Int16Array benutzt die Plattform Byte-Reihenfolge.
  return new Int16Array(buffer)[0] === 256;
})();
console.log(littleEndian); // true oder false

Eigenschaften

DataView.length

Die DataView Konstruktorlängen Eigenschaft hat den Wert 3.

DataView.prototype

Erlaubt es Eigenschaften für alle DataView Objekte hinzuzufügen oder zu modifizieren.

DataView Instanzen

Alle DataView Instanzen erben von DataView.prototype.

Eigenschaften

DataView.prototype.constructor

Spezifiziert die Funktion, die ein Objekt des Prototypen erstellt. Der initialwert ist der Standard eingebaute DataView Konstruktor

DataView.prototype.buffer Read only

Der ArrayBuffer, der von dieser Ansicht repräsentiert wird. Wird bei der Erstellung erzeugt und deswegen kann nur lesend darauf zugegriffen werden.

DataView.prototype.byteLength Read only

Die Länge (in Bytes) von dieser Ansicht, von Beginn des ArrayBuffer. Wird bei der Erstellung erzeugt und deswegen kann nur lesend darauf zugegriffen werden.

DataView.prototype.byteOffset Read only

Das Offset (in Bytes) von dieser Ansicht, von Beginn des ArrayBuffer. Wird bei der Erstellung erzeugt und deswegen kann nur lesend darauf zugegriffen werden.

Methoden

Lesend

DataView.prototype.getInt8()

Gibt eine 8-Bit ganze Zahl mit Vorzeichen (byte) eines spezifizierten Byte-Offsets vom Start der Ansicht zurück.

DataView.prototype.getUint8()

Gibt eine 8-Bit vorzeichenlose ganze Zahl (unsigned byte) eines spezifizierten Byte-Offsets vom Start der Ansicht zurück.

DataView.prototype.getInt16()

Gibt eine 16-Bit ganze Zahl mit Vorzeichen (short) eines spezifizierten Byte-Offsets vom Start der Ansicht zurück.

DataView.prototype.getUint16()

Gibt eine 16-Bit vorzeichenlose ganze Zahl (unsigned short) eines spezifizierten Byte-Offsets vom Start der Ansicht zurück.

DataView.prototype.getInt32()

Gibt eine 32-Bit ganze Zahl mit Vorzeichen (long) eines spezifizierten Byte-Offsets vom Start der Ansicht zurück.

DataView.prototype.getUint32()

Gibt eine 32-Bit vorzeichenlose ganze Zahl (unsigned long) eines spezifizierten Byte-Offsets vom Start der Ansicht zurück.

DataView.prototype.getFloat32()

Gibt eine 32-Bit Gleitkommazahl mit Vorzeichen (float) eines spezifizierten Byte-Offsets vom Start der Ansicht zurück

DataView.prototype.getFloat64()

Gibt eine 64-Bit Gleitkommazahl mit Vorzeichen (double) eines spezifizierten Byte-Offsets vom Start der Ansicht zurück

Schreibend

DataView.prototype.setInt8()

Speichert eine ganze 8-Bit Zahl mit Vorzeichen (byte) an einem spezifizierten Offset vom Start der Ansicht.

DataView.prototype.setUint8()

Speichert eine ganze vorzeichenlose 8-Bit Zahl (unsigned byte) an einem spezifizierten Offset vom Start der Ansicht.

DataView.prototype.setInt16()

Speichert eine ganze 16-Bit Zahl mit Vorzeichen (short) an einem spezifizierten Offset vom Start der Ansicht.

DataView.prototype.setUint16()

Speichert eine ganze vorzeichenlose 16-Bit Zahl (unsigned short) an einem spezifizierten Offset vom Start der Ansicht.

DataView.prototype.setInt32()

Speichert eine ganze 32-Bit Zahl mit Vorzeichen (long) an einem spezifizierten Offset vom Start der Ansicht.

DataView.prototype.setUint32()

Speichert eine ganze vorzeichenlose 32-Bit Zahl (unsigned long) an einem spezifizierten Offset vom Start der Ansicht.

DataView.prototype.setFloat32()

Speichert eine 32-Bit Gleitkommazahl mit Vorzeichen (float) an einem spezifizierten Offset vom Start der Ansicht.

DataView.prototype.setFloat64()

Speichert eine 64-Bit Gleitkommazahl mit Vorzeichen (double) an einem spezifizierten Offset vom Start der Ansicht.

Beispiele

var buffer = new ArrayBuffer(16);
var dv = new DataView(buffer, 0);

dv.setInt16(1, 42);
dv.getInt16(1); //42

Spezifikationen

Browserkompatibilität

Firefox-spezifische Bemerkungen

Mit dem Start von Gecko / SpiderMonkey 40 (Firefox 40 / Thunderbird 40 / SeaMonkey 2.37) wird der new Operator benötigt um eine DataView zu erstellen. Der Aufruf von DataView() als Funktion ohne new erzeugt jetzt einen TypeError.

var dv = DataView(buffer, 0); 
// TypeError: Das Aufrufen des DataView-Konstruktors ohne new ist verboten

var dv = new DataView(buffer, 0);

Siehe auch

• jDataView: JavaScript-Bibliothek welche Polyfills und Erweiterungen für die DataView API in allen Browdern und Node.js zur verfügung stellt.