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