DataView

Beschreibung

Endianness

Mehrbyte-Zahlenformate werden je nach Maschinenarchitektur unterschiedlich im Speicher dargestellt — siehe Endianness für eine Erklärung. DataView-Zugriffs-Methoden bieten explizite Kontrolle darüber, wie auf Daten zugegriffen wird, unabhängig von der Endianness des ausführenden Computers. Zum Beispiel ist der Speicher von WebAssembly immer im Little-Endian-Format, daher sollten Sie DataView anstelle von typisierten Arrays verwenden, um Mehrbyte-Werte zu lesen und zu schreiben. Siehe WebAssembly.Memory für ein Beispiel.

const littleEndian = (() => {
  const buffer = new ArrayBuffer(2);
  new DataView(buffer).setInt16(0, 256, true /* littleEndian */);
  // Int16Array uses the platform's endianness.
  return new Int16Array(buffer)[0] === 256;
})();
console.log(littleEndian); // true or false

Konstruktor

DataView()

Erstellt ein neues DataView-Objekt.

Instanz-Eigenschaften

Diese Eigenschaften sind auf DataView.prototype definiert und werden von allen DataView-Instanzen gemeinsam genutzt.

DataView.prototype.buffer

Der durch diese Sicht referenzierte ArrayBuffer. Festgelegt zur Konstruktionszeit und daher schreibgeschützt.

DataView.prototype.byteLength

Die Länge (in Bytes) dieser Sicht. Festgelegt zur Konstruktionszeit und daher schreibgeschützt.

DataView.prototype.byteOffset

Der Offset (in Bytes) dieser Sicht vom Anfang ihres ArrayBuffer. Festgelegt zur Konstruktionszeit und daher schreibgeschützt.

DataView.prototype.constructor

Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für DataView-Instanzen ist der Anfangswert der DataView-Konstruktor.

DataView.prototype[Symbol.toStringTag]

Der Anfangswert der [Symbol.toStringTag]-Eigenschaft ist der String "DataView". Diese Eigenschaft wird in Object.prototype.toString() verwendet.

Instanz-Methoden

DataView.prototype.getBigInt64()

Liest 8 Bytes beginnend am angegebenen Byte-Offset dieses DataView und interpretiert sie als 64-Bit-Vorzeichen ganze Zahl.

DataView.prototype.getBigUint64()

Liest 8 Bytes beginnend am angegebenen Byte-Offset dieses DataView und interpretiert sie als 64-Bit-Unsignierte ganze Zahl.

DataView.prototype.getFloat16()

Liest 2 Bytes beginnend am angegebenen Byte-Offset dieses DataView und interpretiert sie als 16-Bit-Gleitkommazahl.

DataView.prototype.getFloat32()

Liest 4 Bytes beginnend am angegebenen Byte-Offset dieses DataView und interpretiert sie als 32-Bit-Gleitkommazahl.

DataView.prototype.getFloat64()

Liest 8 Bytes beginnend am angegebenen Byte-Offset dieses DataView und interpretiert sie als 64-Bit-Gleitkommazahl.

DataView.prototype.getInt16()

Liest 2 Bytes beginnend am angegebenen Byte-Offset dieses DataView und interpretiert sie als 16-Bit-Vorzeichen ganze Zahl.

DataView.prototype.getInt32()

Liest 4 Bytes beginnend am angegebenen Byte-Offset dieses DataView und interpretiert sie als 32-Bit-Vorzeichen ganze Zahl.

DataView.prototype.getInt8()

Liest 1 Byte am angegebenen Byte-Offset dieses DataView und interpretiert es als 8-Bit-Vorzeichen ganze Zahl.

DataView.prototype.getUint16()

Liest 2 Bytes beginnend am angegebenen Byte-Offset dieses DataView und interpretiert sie als 16-Bit-Unsignierte ganze Zahl.

DataView.prototype.getUint32()

Liest 4 Bytes beginnend am angegebenen Byte-Offset dieses DataView und interpretiert sie als 32-Bit-Unsignierte ganze Zahl.

DataView.prototype.getUint8()

Liest 1 Byte am angegebenen Byte-Offset dieses DataView und interpretiert es als 8-Bit-Unsignierte ganze Zahl.

DataView.prototype.setBigInt64()

Nimmt ein BigInt und speichert es als 64-Bit-Vorzeichen ganze Zahl in den 8 Bytes beginnend am angegebenen Byte-Offset dieses DataView.

DataView.prototype.setBigUint64()

Nimmt ein BigInt und speichert es als 64-Bit-Unsignierte ganze Zahl in den 8 Bytes beginnend am angegebenen Byte-Offset dieses DataView.

DataView.prototype.setFloat16()

Nimmt eine Zahl und speichert sie als 16-Bit-Gleitkommazahl in den 2 Bytes beginnend am angegebenen Byte-Offset dieses DataView.

DataView.prototype.setFloat32()

Nimmt eine Zahl und speichert sie als 32-Bit-Gleitkommazahl in den 4 Bytes beginnend am angegebenen Byte-Offset dieses DataView.

DataView.prototype.setFloat64()

Nimmt eine Zahl und speichert sie als 64-Bit-Gleitkommazahl in den 8 Bytes beginnend am angegebenen Byte-Offset dieses DataView.

DataView.prototype.setInt16()

Nimmt eine Zahl und speichert sie als 16-Bit-Vorzeichen ganze Zahl in den 2 Bytes am angegebenen Byte-Offset dieses DataView.

DataView.prototype.setInt32()

Nimmt eine Zahl und speichert sie als 32-Bit-Vorzeichen ganze Zahl in den 4 Bytes am angegebenen Byte-Offset dieses DataView.

DataView.prototype.setInt8()

Nimmt eine Zahl und speichert sie als 8-Bit-Vorzeichen ganze Zahl im Byte am angegebenen Byte-Offset dieses DataView.

DataView.prototype.setUint16()

Nimmt eine Zahl und speichert sie als 16-Bit-Unsignierte ganze Zahl in den 2 Bytes am angegebenen Byte-Offset dieses DataView.

DataView.prototype.setUint32()

Nimmt eine Zahl und speichert sie als 32-Bit-Unsignierte ganze Zahl in den 4 Bytes am angegebenen Byte-Offset dieses DataView.

DataView.prototype.setUint8()

Nimmt eine Zahl und speichert sie als 8-Bit-Unsignierte ganze Zahl im Byte am angegebenen Byte-Offset dieses DataView.

Beispiele

Verwendung von DataView

const buffer = new ArrayBuffer(16);
const view = new DataView(buffer, 0);

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill von DataView in core-js
• ArrayBuffer
• SharedArrayBuffer