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

CKTIS / JavaScript

Uint8ClampedArray — bajti z omejenimi vrednostmi

Uint8ClampedArray je tipizirana tabela, ki shranjuje cela števila od 0 do 255. Pri zapisovanju omeji vrednosti na ta razpon in zaokroži ulomke, namesto da bi se vrednosti zavrtele kot pri Uint8Array.

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 Uint8ClampedArray(length)
new Uint8ClampedArray(values)
new Uint8ClampedArray(buffer)
new Uint8ClampedArray(buffer, byteOffset)
new Uint8ClampedArray(buffer, byteOffset, length)

Uint8ClampedArray je standardni tip ECMAScripta: pogled na medpomnilnik, katerega vsak element zaseda en bajt in predstavlja nepredznačeno celo število od 0 do 255. Prebrane vrednosti so tipa Number; to ni običajna tabela Array.

Pri zapisovanju se uporabi ToUint8Clamp: vrednosti pod 0 postanejo 0, vrednosti nad 255 pa 255. Ulomki se zaokrožijo na najbližje celo število; pri natančni polovici se zaokroži na sodo število. Zato 2.5 postane 2, 3.5 pa 4. To se razlikuje od Math.round. NaN postane 0, Infinity postane 255, -Infinity pa 0. Uint8Array ulomke namesto tega odreže, cela števila pa zavrti po modulu 256.

new Uint8ClampedArray(length) ustvari elemente, zapolnjene z ničlami, medtem ko new Uint8ClampedArray(values) vrednosti kopira in pretvori. Oblika z buffer ustvari pogled na obstoječi pomnilnik brez kopiranja; samo ustvarjanje pogleda shranjenih bajtov ne pretvori. Konstruktor zahteva new.

Primer prikazuje omejevanje in zaokroževanje pri ustvarjanju ter poznejši prireditvi. Omejevanje velja za zapisovanje elementov, ne pa za izračune s števili, prebranimi iz tabele. To je funkcija jezika, ne API brskalnika; specifikacija ni tabela združljivosti brskalnikov.

Primeri

const values = new Uint8ClampedArray([-20, 2.5, 3.5, 300, NaN]);
values[0] = 260;
console.log(JSON.stringify(Array.from(values)));

Rezultat

[255,2,4,255,0]

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

Viri