Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Uint16Array — neznamienkové 16-bitové typované pole

Uint16Array je typovaný pohľad na buffer, ktorý ukladá celé čísla od 0 do 65535, pričom na jeden prvok pripadajú 2 bajty. Zistite, ako sa hodnoty konvertujú a aký je rozdiel medzi kopírovaním údajov a zdieľaním pohľadu.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

new Uint16Array(length)
new Uint16Array(iterableOrArrayLike)
new Uint16Array(typedArray)
new Uint16Array(buffer, byteOffset?, length?)

Uint16Array je vstavané typované pole ECMAScriptu, nie obyčajné Array. Každý prvok zaberá 2 bajty a pri čítaní sa vracia ako Number od 0 do 65535. length udáva počet prvkov, byteLength počet bajtov pohľadu a Uint16Array.BYTES_PER_ELEMENT má hodnotu 2.

Konštruktor vyžaduje new. Pri číselnom argumente konštruktor pomocou ToIndex určí počet prvkov inicializovaných na nulu. Napríklad new Uint16Array(3.9) vytvorí tri prvky, zatiaľ čo new Uint16Array(-1) vyvolá výnimku RangeError. Kolekcia poskytne hodnoty na skopírovanie. Variant s ArrayBuffer vytvorí pohľad bez kopírovania: byteOffset sa udáva v bajtoch a musí byť násobkom 2, zatiaľ čo voliteľné length počíta prvky, nie bajty.

Pri zápise sa hodnoty konvertujú namiesto kontroly ich rozsahu: konečné hodnoty Number sa odrežú smerom k nule a potom sa redukujú modulo 65536. Preto sa 65536 zmení na 0, -1 na 65535 a 3.9 na 3. NaN a nekonečná hodnota sa zmenia na 0; hodnoty BigInt spôsobia TypeError. Nejde o orezanie na rozsah.

subarray() zdieľa úložisko s pôvodným poľom, zatiaľ čo slice() kopíruje údaje. Príklad ukazuje konverziu a zmenu pôvodného poľa prostredníctvom pohľadu. Poradie bajtov je natívne pre danú implementáciu; pre binárny formát s výslovne určeným poradím bajtov použite DataView.

Príklady

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}`);

Výsledok

65535,42,65535,3
4 8 2

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje