Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Uint32Array — polje 32-bitnih nepredznačenih celih števil

Uint32Array je tipiziran pogled na medpomnilnik: vsak element zaseda 4 bajte in shranjuje število od 0 do 4294967295. Spoznajte pretvorbo vrednosti, ustvarjanje pogledov ter razliko med deljenim pomnilnikom in kopiranjem.

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 Uint32Array(length)
new Uint32Array(iterableOrArrayLike)
new Uint32Array(typedArray)
new Uint32Array(buffer[, byteOffset[, length]])

Uint32Array je tipizirano polje: pogled na pomnilnik, katerega elementi se berejo kot vrednosti Number od 0 do 4294967295. Vsak element zaseda 4 bajte; length šteje elemente, byteLength pa bajte. To ni običajen Array in nima metode push().

new Uint32Array(length) ustvari medpomnilnik, napolnjen z ničlami. Pri ustvarjanju iz iterabilnega objekta ali drugega tipiziranega polja z elementi tipa Number se vrednosti kopirajo. Če je vir BigInt64Array ali BigUint64Array, konstruktor sproži TypeError, tudi če je izvorno polje prazno. Pri ustvarjanju iz ArrayBuffer si polje z njim deli pomnilnik. byteOffset mora biti večkratnik števila 4; izrecno podani length šteje elemente, ne bajtov.

Pri pisanju se uporabi pretvorba ToUint32: vrednost se zaokroži proti nič in nato se izračuna ostanek pri deljenju z 2 ** 32. Zato -1 postane 4294967295, 2 ** 32 + 7 pa 7. NaN in neskončnosti postanejo 0; pisanje vrednosti BigInt sproži TypeError. Gre za pretvorbo, ne za preverjanje obsega.

subarray() si deli pomnilnik, slice() pa kopira elemente. Vrstni red bajtov je odvisen od izvedbe; za binarne formate, ki zahtevajo izrecen vrstni red bajtov, uporabite DataView. V primeru sprememba view[0] spremeni tudi values[1].

Primeri

const values = new Uint32Array([1, -1, 2 ** 32 + 7, 3.9]);
const view = values.subarray(1, 3);
view[0] = 42;
console.log(values.join(","));
console.log(values.length, values.byteLength, Uint32Array.BYTES_PER_ELEMENT);

Rezultat

1,42,7,3
4 16 4

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri