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

CKTIS / JavaScript

Типизирани масиви: брой елементи, байтове на изгледа и байтове на буфера

Разграничавайте обекта на буфера (`.buffer`), броя елементи (`.length`), байтовете на изгледа (`.byteLength`) и текущия размер на целия буфер (`.buffer.byteLength`).

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

Синтаксис

const buffer = new ArrayBuffer(byteCount);
const view = new Uint16Array(buffer, byteOffset, elementCount);
view.buffer       // backing buffer object
view.length       // element count in the view
view.byteLength   // byte count in the view
buffer.byteLength // current byte count of the entire buffer

view.buffer връща същия обект на буфера, без да копира данните: ArrayBuffer или, при изглед върху споделена памет, SharedArrayBuffer. view.length брои елементите, а view.byteLength — байтовете на изгледа: view.length * view.BYTES_PER_ELEMENT. view.buffer.byteLength дава текущия размер на целия буфер в байтове, а не максималния. SharedArrayBuffer има собствен getter byteLength. Това са свойства само за четене, а не методи.

new Uint16Array(n) заделя памет за n елемента. За разлика от него new Uint16Array(buffer, byteOffset, length) създава изглед без копиране: отместването е в байтове, а дължината — в елементи. Неподравнено отместване или диапазон извън границите на буфера предизвиква RangeError. Ако получателят трябва да получи само данните на изгледа, предайте копие на неговия диапазон от байтове, а не view.buffer, който дава достъп и до байтове извън изгледа.

При ArrayBuffer с променлив размер (ECMAScript 2024), ако пропуснете length, изгледът обхваща всички цели елементи, които се побират от отместването му до края на буфера. Изрично зададено length фиксира диапазона на изгледа. Намаляването на буфера може да изведе изгледа извън границите му: тогава view.length и view.byteLength връщат 0. Повторното увеличаване може да направи диапазона отново валиден. Преди да използвате преоразмеряване, проверете дали целевата среда го поддържа.

Прехвърлянето на ArrayBuffer в уеб среда може да отдели първоначалния буфер от данните му. view.buffer продължава да връща същия обект, но buffer.byteLength, view.length и view.byteLength връщат 0. Само по нулата не може да се заключи, че буферът е отделен: буферът или изгледът може просто да е празен.

Примери

{
  const buffer = new ArrayBuffer(16);
  const view = new Uint16Array(buffer, 4, 3);
  console.log(`${view.buffer === buffer} | ${view.length} | ${view.byteLength} | ${buffer.byteLength}`);
}

Резултат

true | 3 | 6 | 16

`true | 3 | 6 | 16` потвърждава, че изгледът използва същия буфер: от отместване 4 байта той обхваща 3 елемента по 2 байта в буфер с размер 16 байта.

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

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

Източници