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

CKTIS / JavaScript

Int32Array: 32-bitna cela števila s predznakom

Int32Array shranjuje števila kot 32-bitna cela števila s predznakom od -2147483648 do 2147483647 s 4 bajti na element.

Različica: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaksa

new Int32Array(); new Int32Array(length); new Int32Array(source); new Int32Array(buffer[, byteOffset[, length]])

new Int32Array(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, byteOffset mora biti večkratnik 4 in BYTES_PER_ELEMENT je 4.

Zapis uporabi ToNumber, odreže ulomek, reducira modulo 2^32 in rezultat razume s predznakom. Zato 2147483648 postane -2147483648, 4294967295 postane -1, NaN in neskončnosti pa 0. Zapis BigInt ali BigInt typed array kot vir sproži TypeError. Vrstni red bajtov je izvoren; za izrecni endianness uporabite DataView.

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

Primeri

const values = new Int32Array([2147483647, 2147483648, 4294967295, -2147483649, 3.9, NaN, Infinity]);
console.log(Array.from(values).join(","));
console.log(Int32Array.BYTES_PER_ELEMENT, new Int32Array(2.9).length, new Int32Array(-0.5).length);

const buffer = new ArrayBuffer(12);
const view = new Int32Array(buffer, 4, 1);
view[0] = -123456;
console.log(view.byteOffset, view.byteLength, view[0]);
try { view[0] = 1n; } catch (error) { console.log(error instanceof TypeError); }

Rezultat

2147483647,-2147483648,-1,2147483647,3,0,0
4 2 0
4 4 -123456
true

Viri