CKTIS / JavaScript
Tipizirani nizovi: broj elemenata, bajtovi pogleda i bajtovi međuspremnika
Razlikujte objekt međuspremnika (`.buffer`), broj elemenata (`.length`), veličinu pogleda u bajtovima (`.byteLength`) i trenutačnu veličinu cijelog međuspremnika (`.buffer.byteLength`).
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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 bufferview.buffer vraća isti objekt međuspremnika bez kopiranja podataka: ArrayBuffer ili, za pogled na dijeljenu memoriju, SharedArrayBuffer. view.length broji elemente, dok view.byteLength broji bajtove pogleda: view.length * view.BYTES_PER_ELEMENT. view.buffer.byteLength daje trenutačnu veličinu cijelog međuspremnika u bajtovima, a ne najveću moguću veličinu. SharedArrayBuffer ima vlastiti getter byteLength. To su svojstva samo za čitanje, a ne metode.
new Uint16Array(n) rezervira prostor za n elemenata. Nasuprot tomu, new Uint16Array(buffer, byteOffset, length) stvara pogled bez kopiranja: pomak se izražava u bajtovima, a duljina u elementima. Neporavnat pomak ili raspon izvan granica međuspremnika uzrokuje RangeError. Ako primatelj treba dobiti samo podatke iz pogleda, proslijedite kopiju njegova raspona bajtova, a ne view.buffer, koji daje pristup i bajtovima izvan pogleda.
Za ArrayBuffer promjenjive veličine (ECMAScript 2024), ako izostavite length, pogled obuhvaća sve cijele elemente koji stanu od njegova pomaka do kraja međuspremnika. Izričito zadan length čini raspon pogleda fiksnim. Smanjivanjem međuspremnika pogled može izaći iz njegovih granica: view.length i view.byteLength tada vraćaju 0. Ponovno povećanje može vratiti raspon unutar granica. Prije uporabe provjerite podržava li ciljno okruženje promjenu veličine.
Prijenos objekta ArrayBuffer na webu može odvojiti izvorni međuspremnik od podataka. view.buffer i dalje vraća isti objekt, ali buffer.byteLength, view.length i view.byteLength vraćaju 0. Sama nula ne dokazuje odvajanje: međuspremnik ili pogled može jednostavno biti prazan.
Primjeri
{
const buffer = new ArrayBuffer(16);
const view = new Uint16Array(buffer, 4, 3);
console.log(`${view.buffer === buffer} | ${view.length} | ${view.byteLength} | ${buffer.byteLength}`);
}Rezultat
true | 3 | 6 | 16
`true | 3 | 6 | 16` potvrđuje da pogled koristi isti međuspremnik: od pomaka od 4 bajta obuhvaća 3 elementa od po 2 bajta u međuspremniku od 16 bajtova.
Povezane lekcije
- JavaScript · Lekcija 5 · Napredno · Verzija: 4
Izvori
- ECMAScript 2024 — get %TypedArray%.prototype.buffer
- ECMAScript 2024 — get %TypedArray%.prototype.length
- ECMAScript 2024 — get %TypedArray%.prototype.byteLength
- ECMAScript 2024 — get ArrayBuffer.prototype.byteLength
- ECMAScript 2024 — get SharedArrayBuffer.prototype.byteLength
- ECMAScript 2024 — InitializeTypedArrayFromArrayBuffer
- ECMAScript 2024 — ArrayBuffer.prototype.resize
- MDN — TypedArray: Behavior when viewing a resizable buffer
- HTML Standard — StructuredSerializeWithTransfer