CKTIS / JavaScript
Uint16Array — bezznaménkové 16bitové typované pole
Uint16Array je typovaný pohled na buffer, který ukládá celá čísla od 0 do 65535, přičemž na každý prvek připadají 2 bajty. Zjistěte, jak se hodnoty převádějí a jaký je rozdíl mezi kopírováním dat a sdílením pohledu.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new Uint16Array(length)
new Uint16Array(iterableOrArrayLike)
new Uint16Array(typedArray)
new Uint16Array(buffer, byteOffset?, length?)Uint16Array je vestavěné typované pole ECMAScriptu, nikoli běžné Array. Každý prvek zabírá 2 bajty a při čtení se vrací jako Number od 0 do 65535. length udává počet prvků, byteLength počet bajtů pohledu a Uint16Array.BYTES_PER_ELEMENT má hodnotu 2.
Konstruktor vyžaduje new. U číselného argumentu konstruktor pomocí ToIndex určí počet prvků inicializovaných na nulu. Například new Uint16Array(3.9) vytvoří tři prvky, zatímco new Uint16Array(-1) vyvolá výjimku RangeError. Kolekce dodá hodnoty ke zkopírování. Varianta s ArrayBuffer vytvoří pohled bez kopírování: byteOffset se udává v bajtech a musí být násobkem 2, zatímco nepovinné length počítá prvky, nikoli bajty.
Při zápisu se hodnoty převádějí, místo aby se ověřoval jejich rozsah: konečné hodnoty Number se zaokrouhlí směrem k nule a poté se redukují modulo 65536. Hodnota 65536 se tedy změní na 0, -1 na 65535 a 3.9 na 3. NaN a nekonečna se změní na 0; hodnoty BigInt způsobí TypeError. Nejde o oříznutí na rozsah.
subarray() sdílí úložiště s původním polem, zatímco slice() data kopíruje. Příklad ukazuje převod a změnu původního pole prostřednictvím pohledu. Pořadí bajtů je nativní pro danou implementaci; pro binární formát s výslovně určeným pořadím bajtů použijte DataView.
Pří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ýsledek
65535,42,65535,3 4 8 2
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.