CKTIS / JavaScript
TypedArray: буфер, отместване, размер в байтове и брой елементи
Разграничи целия буфер от диапазона в байтове и броя елементи в изгледа. Виж какво връщат свойствата след промяна на размера или отделяне на буфера.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
view.buffer
view.byteOffset
view.byteLength
view.length
new Uint16Array(buffer)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)Екземпляр като Uint16Array е изглед към буфер. TypedArray е име на семейство типове, а не глобален конструктор, който може да се извика пряко. Четирите свойства са наследени и имат getter, но нямат setter. Извикването на такъв getter върху обект, който не е типизиран масив, предизвиква TypeError. view.length не е Uint16Array.length, което показва броя на декларираните параметри на конструктора.
view.buffer връща същия базов обект ArrayBuffer или SharedArrayBuffer, а не копие. view.byteOffset показва къде започва изгледът спрямо началото на буфера, а view.byteLength — размера на изгледа, и двете в байтове. view.length брои елементи. Ако и двете прочитания отразяват един и същ размер на изгледа, е в сила view.byteLength === view.length * view.BYTES_PER_ELEMENT. Getter-ите се извикват поотделно: ако друг агент увеличи размера на базовия SharedArrayBuffer между прочитанията, getter-ите на изглед с адаптивна дължина могат да отчетат различни размери и сравнението може да върне false. view.buffer.byteLength измерва целия буфер, а не само изгледа.
В new Uint16Array(buffer, byteOffset, length) вторият аргумент е в байтове, а третият — в елементи. Отместване, което не е подравнено спрямо размера на елемента, или диапазон извън буфера предизвиква RangeError. Записите се виждат през припокриващи се изгледи към същия буфер. Предаването на изглед не скрива останалите байтове: за да предоставиш достъп само до валиден диапазон, копирай байтовете му в отделен буфер.
При буфер с фиксиран размер пропускането на length обхваща остатъка, в който трябва да се побират само цели елементи. При ArrayBuffer с променлив размер или разширяем SharedArrayBuffer пропускането на length или подаването на undefined създава изглед с адаптивна дължина: той брои целите елементи, които се побират от отместването нататък. Изрично подаденият брой елементи фиксира дължината на изгледа.
Намаляването на буфера може да остави изгледа извън границите му, а повторното увеличаване може да го върне в тях. Ако изгледът е извън границите или неговият ArrayBuffer е отделен (например при прехвърляне), трите числови getter-а връщат 0, но buffer продължава да връща същия обект. Валиден празен изглед може да има ненулево отместване. Промяната на размера и разширяването са описани в ECMAScript 2024; провери поддръжката в целевата среда за изпълнение.
Примери
{
const buffer = new ArrayBuffer(16);
const view = new Uint16Array(buffer, 4, 3);
console.log([
view.buffer === buffer,
view.byteOffset,
view.byteLength,
view.length,
view.buffer.byteLength,
].join(" "));
view[0] = 513;
console.log(String(new Uint16Array(buffer)[2]));
}Резултат
true 4 6 3 16 513
Изгледът започва от байт 4 и обхваща три двубайтови елемента, тоест 6 от 16 байта. Записът на индекс 0 се вижда на индекс 2 в изгледа към целия буфер.
Свързани уроци
- JavaScript · Урок 2 · Напреднало · Версия: 4