Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Int8Array: 8-bitna cela števila s predznakom

Int8Array shranjuje števila kot 8-bitna cela števila s predznakom od -128 do 127 z enim bajtom na element.

Različica: 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?) ustvari številski typed array iz dolžine, iterable/array-like, drugega številskega typed array ali ArrayBuffer/SharedArrayBuffer. Oblika z medpomnilnikom deli bajte brez kopije. Vsak celoštevilski byteOffset je poravnan za enobajtni element in BYTES_PER_ELEMENT je 1.

Zapis uporabi ToNumber, odreže ulomek, reducira modulo 2^8 in rezultat razume s predznakom. Zato 128 postane -128, 255 postane -1, NaN in neskončnosti pa 0. Zapis BigInt ali BigInt typed array kot vir sproži TypeError. Vrstni red bajtov za en bajt ni pomemben.

Dolžina gre skozi ToIndex: ulomki se odrežejo, NaN/undefined postaneta 0 in -0.5 da 0. Negativen rezultat po ToIntegerOrInfinity, neskončnost ali obseg zunaj medpomnilnika sproži RangeError; odklopljen medpomnilnik sproži TypeError. Tip je standarden od ECMAScript 2015.

Primeri

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

Viri