CKTIS / JavaScript
Uint8ClampedArray — bajtovi s ograničenim vrijednostima
Uint8ClampedArray tipizirano je polje koje pohranjuje cijele brojeve od 0 do 255. Pri zapisivanju ograničava vrijednosti na taj raspon i zaokružuje razlomke, umjesto da se vrijednosti prebacuju kao kod Uint8Array.
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 Uint8ClampedArray(length)
new Uint8ClampedArray(values)
new Uint8ClampedArray(buffer)
new Uint8ClampedArray(buffer, byteOffset)
new Uint8ClampedArray(buffer, byteOffset, length)Uint8ClampedArray standardni je tip ECMAScripta: pogled na međuspremnik čiji svaki element zauzima jedan bajt i predstavlja nepredznačeni cijeli broj od 0 do 255. Pročitane vrijednosti tipa su Number; to nije obično polje Array.
Pri zapisivanju se primjenjuje ToUint8Clamp: vrijednosti manje od 0 postaju 0, a vrijednosti veće od 255 postaju 255. Razlomci se zaokružuju na najbliži cijeli broj; kod točne polovice zaokružuje se na parni broj. Zato 2.5 postaje 2, a 3.5 postaje 4. To se razlikuje od Math.round. NaN postaje 0, Infinity postaje 255, a -Infinity postaje 0. Uint8Array umjesto toga skraćuje razlomke, a cijele brojeve prebacuje po modulu 256.
new Uint8ClampedArray(length) stvara elemente ispunjene nulama, dok new Uint8ClampedArray(values) kopira i pretvara vrijednosti. Oblik s buffer stvara pogled na postojeću memoriju bez kopiranja; samo stvaranje pogleda ne pretvara pohranjene bajtove. Konstruktor zahtijeva new.
Primjer prikazuje ograničavanje i zaokruživanje pri stvaranju te naknadnoj dodjeli. Ograničavanje se primjenjuje na zapisivanje elemenata, a ne na izračune s brojevima pročitanima iz polja. To je značajka jezika, a ne API preglednika; specifikacija nije tablica kompatibilnosti preglednika.
Primjeri
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]
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.