CKTIS / JavaScript
Uint8ClampedArray — bajty s obmedzenými hodnotami
Uint8ClampedArray je typované pole, ktoré ukladá celé čísla od 0 do 255. Pri zápise obmedzuje hodnoty na tento rozsah a zaokrúhľuje zlomky, namiesto toho, aby hodnoty pretekali ako v Uint8Array.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new Uint8ClampedArray(length)
new Uint8ClampedArray(values)
new Uint8ClampedArray(buffer)
new Uint8ClampedArray(buffer, byteOffset)
new Uint8ClampedArray(buffer, byteOffset, length)Uint8ClampedArray je štandardný typ ECMAScriptu: pohľad na buffer, ktorého každý prvok zaberá jeden bajt a predstavuje nezáporné celé číslo od 0 do 255. Načítané hodnoty majú typ Number; nejde o bežné pole Array.
Pri zápise sa použije ToUint8Clamp: hodnoty menšie ako 0 sa zmenia na 0 a hodnoty väčšie ako 255 na 255. Zlomky sa zaokrúhľujú na najbližšie celé číslo; pri presnej polovici sa zaokrúhľuje na párne číslo. Preto sa 2.5 zmení na 2 a 3.5 na 4. To sa líši od Math.round. NaN sa zmení na 0, Infinity na 255 a -Infinity na 0. Uint8Array zlomky namiesto toho skracuje a celé čísla prevádza modulo 256.
new Uint8ClampedArray(length) vytvorí prvky vyplnené nulami, zatiaľ čo new Uint8ClampedArray(values) hodnoty skopíruje a prevedie. Forma s buffer vytvorí pohľad na existujúcu pamäť bez kopírovania; samotné vytvorenie pohľadu uložené bajty neprevedie. Konštruktor vyžaduje new.
Príklad ukazuje obmedzenie a zaokrúhľovanie pri vytvorení aj pri následnom priradení. Obmedzenie sa uplatňuje pri zápise do prvkov, nie pri výpočtoch s číslami načítanými z poľa. Ide o funkciu jazyka, nie o API prehliadača; špecifikácia nie je tabuľkou kompatibility prehliadačov.
Príklady
const values = new Uint8ClampedArray([-20, 2.5, 3.5, 300, NaN]);
values[0] = 260;
console.log(JSON.stringify(Array.from(values)));Výsledok
[255,2,4,255,0]
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.