Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Uint16Array — neoznačeni 16-bitni tipizirani niz

Uint16Array je tipizirani prikaz međuspremnika koji pohranjuje cijele brojeve od 0 do 65535, uz 2 bajta po elementu. Saznajte kako se vrijednosti pretvaraju i koja je razlika između kopiranja podataka i dijeljenja prikaza.

Verzija: 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 ugrađeni je tipizirani niz u ECMAScriptu, a ne običan Array. Svaki element zauzima 2 bajta i pri čitanju se vraća kao Number od 0 do 65535. length označava broj elemenata, byteLength broj bajtova prikaza, a Uint16Array.BYTES_PER_ELEMENT iznosi 2.

Konstruktor zahtijeva new. Ako je argument brojčan, konstruktor primjenjuje ToIndex kako bi odredio broj elemenata s početnom vrijednošću nula. Primjerice, new Uint16Array(3.9) stvara tri elementa, dok new Uint16Array(-1) baca iznimku RangeError. Kolekcija daje vrijednosti za kopiranje. Varijanta s ArrayBuffer stvara prikaz bez kopiranja: byteOffset se izražava u bajtovima i mora biti višekratnik broja 2, dok neobavezni length broji elemente, a ne bajtove.

Pri zapisivanju se vrijednosti pretvaraju umjesto da im se provjerava raspon: konačne vrijednosti Number skraćuju se prema nuli, a zatim se reduciraju modulo 65536. Zato 65536 postaje 0, -1 postaje 65535, a 3.9 postaje 3. NaN i beskonačnosti postaju 0; vrijednosti BigInt uzrokuju TypeError. Ne radi se o ograničavanju na raspon.

subarray() dijeli spremište s izvornikom, dok slice() kopira podatke. Primjer prikazuje pretvorbu i izmjenu izvornika putem prikaza. Redoslijed bajtova svojstven je implementaciji; za binarni format s izričito određenim redoslijedom bajtova upotrijebite DataView.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori