База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

DataView.prototype.getUint16(): четене на 16-битово цяло число без знак

Прочетете два байта от изглед DataView като 16-битово цяло число без знак, като спазите реда на байтовете, зададен от формата на данните.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

DataView.prototype.getUint16 е метод на екземпляр на DataView. Той прочита два последователни байта, без да променя буфера, и връща стойност от тип Number между 0 и 65535 включително. Ако полето е със знак, използвайте getInt16().

byteOffset е отместване в байтове спрямо началото на изгледа, а не спрямо началото на буфера или в 16-битови единици. Няма изискване за подравняване: нечетно отместване е валидно, ако и двата байта са в границите на изгледа.

Незадължителният аргумент littleEndian се преобразува в булева стойност. true избира little-endian (първо е най-младшият байт); false или пропускането на аргумента избира big-endian (първо е най-старшият байт). Избирайте реда на байтовете според формата на данните, а не според архитектурата на процесора.

Отместването се преобразува в целочислен индекс: undefined става 0, а дробните стойности се отрязват към нулата. Отрицателният резултат от преобразуването води до RangeError, както и опитът да се прочетат два байта, които не се побират във валиден изглед. TypeError възниква например ако this не е екземпляр на DataView, буферът е отделен или самият изглед излиза извън границите на буфера след свиването му.

Примери

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

Резултат

4660
13330
RangeError

Изгледът започва от индекс `1` в буфера, затова отместване `1` в изгледа избира `0x12` и `0x34`. Четенето по подразбиране връща `4660`, а четенето с `true` връща `13330`. При отместване `2` в изгледа остава само един байт, затова кодът извежда `RangeError`.

Свързани уроци

  • JavaScript · Урок 2 · Напреднало · Версия: 4

Източници