CKTIS / JavaScript
Int8Array: 8bitová celá čísla se znaménkem
Int8Array ukládá čísla jako 8bitová celá čísla se znaménkem od -128 do 127 s jedním bajtem na prvek.
Verze: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
new Int8Array(); new Int8Array(length); new Int8Array(source); new Int8Array(buffer[, byteOffset[, length]])new Int8Array(source?, byteOffset?, length?) vytvoří číselný typed array z délky, iterable/array-like, jiného číselného typed array nebo ArrayBuffer/SharedArrayBuffer. Bufferová forma sdílí bajty bez kopie. Každý celočíselný byteOffset je pro jednobajtový prvek zarovnaný a BYTES_PER_ELEMENT je 1.
Zápis použije ToNumber, ořízne zlomek, redukuje modulo 2^8 a výsledek vyloží se znaménkem. Proto se 128 změní na -128, 255 na -1 a NaN i nekonečna na 0. Zápis BigInt nebo BigInt typed array jako zdroj vyvolá TypeError. Pořadí bajtů nemá pro jediný bajt význam.
Délka prochází ToIndex: zlomky se oříznou, NaN/undefined se změní na 0 a -0.5 dá 0. Záporný výsledek po ToIntegerOrInfinity, nekonečno nebo rozsah mimo buffer vyvolá RangeError; odpojený buffer vyvolá TypeError. Typ je standardní od ECMAScript 2015.
Příklady
const values = new Int8Array([127, 128, 255, -129, 3.9, NaN, Infinity]);
console.log(Array.from(values).join(","));
console.log(Int8Array.BYTES_PER_ELEMENT, new Int8Array(2.9).length, new Int8Array(-0.5).length);
const buffer = new ArrayBuffer(4);
const view = new Int8Array(buffer, 1, 2);
view.set([-5, 120]);
console.log(view.byteOffset, view.byteLength, Array.from(view).join(","));
try { view[0] = 1n; } catch (error) { console.log(error instanceof TypeError); }Výsledek
127,-128,-1,127,3,0,0 1 2 0 1 2 -5,120 true