CKTIS / JavaScript
Uint16Array — nepredznačeno 16-bitno tipizirano polje
Uint16Array je tipiziran pogled na medpomnilnik, ki shranjuje cela števila od 0 do 65535, pri čemer vsak element zaseda 2 bajta. Spoznajte pretvorbo vrednosti in razliko med kopiranjem podatkov ter deljenjem pogleda.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
new Uint16Array(length)
new Uint16Array(iterableOrArrayLike)
new Uint16Array(typedArray)
new Uint16Array(buffer, byteOffset?, length?)Uint16Array je vgrajeno tipizirano polje ECMAScript, ne običajen Array. Vsak element zaseda 2 bajta in se pri branju vrne kot Number od 0 do 65535. length podaja število elementov, byteLength število bajtov pogleda, Uint16Array.BYTES_PER_ELEMENT pa je 2.
Konstruktor zahteva new. Pri številskem argumentu konstruktor z operacijo ToIndex določi število elementov z začetno vrednostjo nič. Na primer, new Uint16Array(3.9) ustvari tri elemente, new Uint16Array(-1) pa sproži izjemo RangeError. Zbirka poda vrednosti za kopiranje. Različica z ArrayBuffer ustvari pogled brez kopiranja: byteOffset je izražen v bajtih in mora biti večkratnik 2, neobvezni length pa šteje elemente, ne bajtov.
Pri zapisovanju se vrednosti pretvorijo, namesto da bi se preveril njihov obseg: končne vrednosti Number se odrežejo proti ničli in nato reducirajo modulo 65536. Tako 65536 postane 0, -1 postane 65535, 3.9 pa postane 3. NaN in neskončnosti postanejo 0; vrednosti BigInt povzročijo TypeError. To ni omejevanje vrednosti na obseg.
subarray() si deli pomnilnik z izvirnikom, medtem ko slice() kopira podatke. Primer prikazuje pretvorbo in spreminjanje izvirnika prek pogleda. Vrstni red bajtov je lasten implementaciji; za binarno obliko z izrecno določenim vrstnim redom bajtov uporabite DataView.
Primeri
const values = new Uint16Array([65535, 65536, -1, 3.9]);
const view = values.subarray(1, 3);
view[0] = 42;
console.log(values.join(","));
console.log(`${values.length} ${values.byteLength} ${Uint16Array.BYTES_PER_ELEMENT}`);Rezultat
65535,42,65535,3 4 8 2
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.