CKTIS / JavaScript
Int8Array: 8-bits gehele getallen met teken
Int8Array bewaart getallen als 8-bits gehele getallen met teken van -128 tot en met 127, met één byte per element.
Versie: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
new Int8Array(); new Int8Array(length); new Int8Array(source); new Int8Array(buffer[, byteOffset[, length]])new Int8Array(source?, byteOffset?, length?) maakt een numerieke typed array uit lengte, iterable/array-achtig, andere numerieke typed array of ArrayBuffer/SharedArrayBuffer. De buffervorm deelt bytes zonder kopie. Elke gehele byteOffset is uitgelijnd voor een element van één byte en BYTES_PER_ELEMENT is 1.
Toewijzing past ToNumber toe, kapt de breuk af, reduceert modulo 2^8 en interpreteert het resultaat met teken. Daardoor wordt 128 -128, 255 wordt -1, en NaN en oneindigheden worden 0. BigInt toewijzen of een BigInt typed array als bron werpt TypeError. Bytevolgorde is bij één byte niet relevant.
De lengte doorloopt ToIndex: breuken worden afgekapt, NaN/undefined worden 0 en -0.5 geeft 0. Negatief resultaat na ToIntegerOrInfinity, oneindigheid of bereik buiten de buffer werpt RangeError; losgekoppelde buffer werpt TypeError. Het type is standaard sinds ECMAScript 2015.
Voorbeelden
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); }Resultaat
127,-128,-1,127,3,0,0 1 2 0 1 2 -5,120 true