KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

DataView.prototype.getUint16(): een 16-bits geheel getal zonder teken lezen

Lees twee bytes uit een DataView als een 16-bits geheel getal zonder teken, met de bytevolgorde die het gegevensformaat voorschrijft.

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

Syntax

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

DataView.prototype.getUint16 is een instantiemethode van DataView. De methode leest twee opeenvolgende bytes zonder de buffer te wijzigen en geeft een Number van 0 tot en met 65535 terug. Gebruik getInt16() als het veld een teken heeft.

byteOffset telt bytes vanaf het begin van de view, niet vanaf het begin van de buffer en niet in eenheden van 16 bits. Uitlijning is niet vereist: een oneven offset is geldig als beide bytes binnen de view vallen.

Het optionele argument littleEndian wordt omgezet in een booleaanse waarde. true kiest little-endian (minst significante byte eerst); false of het weglaten van het argument kiest big-endian (meest significante byte eerst). Baseer de bytevolgorde op het gegevensformaat, niet op de processorarchitectuur.

De offset wordt omgezet in een gehele index: undefined wordt 0 en niet-gehele waarden worden afgekapt richting nul. Een negatieve uitkomst levert een RangeError op, net als een leespoging waarbij de twee bytes niet binnen een geldige view vallen. Een TypeError treedt bijvoorbeeld op als this geen DataView-instantie is, als de buffer is losgekoppeld of als de view zelf buiten de grenzen van de buffer valt nadat die is verkleind.

Voorbeelden

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);
}

Resultaat

4660
13330
RangeError

De view begint bij bufferindex `1`, dus offset `1` binnen de view selecteert `0x12` en `0x34`. De standaardleesbewerking geeft `4660` terug en de leesbewerking met `true` geeft `13330` terug. Bij offset `2` is er nog maar één byte over in de view, dus de code toont `RangeError`.

Gerelateerde lessen

  • JavaScript · Les 2 · Gevorderd · Versie: 4

Bronnen