WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

DataView.prototype.getUint16(): eine vorzeichenlose 16-Bit-Ganzzahl lesen

Lies zwei Bytes aus einem DataView als vorzeichenlose 16-Bit-Ganzzahl und wähle die vom Datenformat vorgegebene Byte-Reihenfolge.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

view.getUint16(byteOffset)
view.getUint16(byteOffset, littleEndian)

DataView.prototype.getUint16 ist eine Instanzmethode von DataView. Sie liest zwei aufeinanderfolgende Bytes, ohne den Puffer zu verändern, und gibt einen Number-Wert von 0 bis einschließlich 65535 zurück. Verwende getInt16(), wenn das Feld vorzeichenbehaftet ist.

byteOffset zählt Bytes ab dem Beginn der Ansicht, nicht ab dem Beginn des Puffers und nicht in 16-Bit-Einheiten. Es gibt keine Ausrichtungsanforderung: Ein ungerader Offset ist gültig, wenn beide Bytes in die Ansicht passen.

Das optionale Argument littleEndian wird in einen booleschen Wert umgewandelt. true wählt Little Endian (niederwertigstes Byte zuerst); false oder das Weglassen des Arguments wählt Big Endian (höchstwertiges Byte zuerst). Die Byte-Reihenfolge richtet sich nach dem Datenformat, nicht nach der Prozessorarchitektur.

Der Offset wird in einen ganzzahligen Index umgewandelt: undefined wird zu 0, und Nachkommastellen werden in Richtung null abgeschnitten. Ein negatives Ergebnis dieser Umwandlung führt zu einem RangeError, ebenso ein Lesezugriff, bei dem nicht beide Bytes in eine gültige Ansicht passen. Ein TypeError tritt zum Beispiel auf, wenn this keine DataView-Instanz ist, der Puffer abgetrennt wurde oder die Ansicht nach dem Verkleinern des Puffers selbst dessen Grenzen überschreitet.

Beispiele

const bytes = new Uint8Array([0xaa, 0xbb, 0x12, 0x34, 0xcc]);
const view = new DataView(bytes.buffer, 1, 3);

console.log(view.getUint16(1));
console.log(view.getUint16(1, true));

try {
  view.getUint16(2);
} catch (error) {
  console.log(error.name);
}

Ergebnis

4660
13330
RangeError

Die Ansicht beginnt bei Pufferindex `1`. Der Offset `1` in der Ansicht wählt daher `0x12` und `0x34` aus. Der Standardaufruf liefert `4660`, der Aufruf mit `true` liefert `13330`. Beim Offset `2` bleibt in der Ansicht nur ein Byte übrig, daher gibt der Code `RangeError` aus.

Zugehörige Lektionen

  • JavaScript · Lektion 2 · Fortgeschritten · Version: 4

Quellen