CKTIS / JavaScript
Int8Array: 8-bitni cijeli brojevi s predznakom
Int8Array sprema brojeve kao 8-bitne cijele brojeve s predznakom od -128 do 127 s jednim bajtom po elementu.
Verzija: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaksa
new Int8Array(); new Int8Array(length); new Int8Array(source); new Int8Array(buffer[, byteOffset[, length]])new Int8Array(source?, byteOffset?, length?) stvara brojčani typed array iz duljine, iterable/array-like, drugog brojčanog typed array ili ArrayBuffer/SharedArrayBuffer. Oblik s međuspremnikom dijeli bajtove bez kopije. Svaki cjelobrojni byteOffset poravnat je za jednobajtni element, a BYTES_PER_ELEMENT je 1.
Zapis primjenjuje ToNumber, odsijeca razlomak, reducira modulo 2^8 i rezultat tumači s predznakom. Zato 128 postaje -128, 255 postaje -1, a NaN i beskonačnosti 0. Zapis BigInt ili BigInt typed array kao izvor baca TypeError. Redoslijed bajtova nije važan za jedan bajt.
Duljina prolazi kroz ToIndex: razlomci se odsijecaju, NaN/undefined postaju 0 i -0.5 daje 0. Negativan rezultat nakon ToIntegerOrInfinity, beskonačnost ili raspon izvan međuspremnika baca RangeError; odvojen međuspremnik baca TypeError. Tip je standardan od ECMAScript 2015.
Primjeri
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); }Rezultat
127,-128,-1,127,3,0,0 1 2 0 1 2 -5,120 true