Constructeur Int32Array()

Syntaxe

new Int32Array(); // apparu avec ES2017
new Int32Array(longueur);
new Int32Array(tableauType);
new Int32Array(object);
new Int32Array(buffer);
new Int32Array(buffer, decalageOctets);
new Int32Array(buffer, decalageOctets, longueur);

Paramètres

longueur

Lorsque le constructeur est appelé avec un argument longueur, un tableau interne de tampon de mémoire est créé avec une taille en octets de longueur multipliée par BYTES_PER_ELEMENT et dont les éléments sont des zéros.

tableauType

Lorsque le constructeur est appelé avec un argument tableauType, qui peut être un tableau typé de n'importe quel type non bigint (comme Int16Array), tableauType est copié dans un nouveau tableau typé et chaque valeur de tableauType est convertie dans le type correspondant au constructeur avant d'être copiée dans le nouveau tableau. La longueur du nouveau tableau typé est égale à celle de l'argument tableauType.

object

Lorsque le constructeur est appelé avec un argument objet quelconque, un nouveau tableau typé est créé, de la même façon qu'avec un appel à la méthode TypedArray.from().

buffer, decalageOctets, longueur

Lorsqu'il est appelé avec un argument buffer, et éventuellement des arguments decalageOctets et longueur, le constructeur crée une nouvelle vue sous la forme d'un tableau typé qui porte sur l'objet ArrayBuffer donné par le paramètre buffer. Les paramètres decalageOctets et longueur indiquent l'intervalle de mémoire exposé à la vue formée par le tableau typé. Si ces deux derniers paramètres sont absents, c'est l'ensemble de buffer qui sera vu ; si seul longueur est absent, c'est tout buffer qui sera vu à partir de decalageOctets.

Exemples

Plusieurs façons de créer un objet Int32Array

// À partir d'une longueur
const int32 = new Int32Array(2);
int32[0] = 42;
console.log(int32[0]); // 42
console.log(int32.length); // 2
console.log(int32.BYTES_PER_ELEMENT); // 4

// À partir d'un tableau
const arr = new Int32Array([21, 31]);
console.log(arr[1]); // 31

// À partir d'un autre tableau typé
const x = new Int32Array([21, 31]);
const y = new Int32Array(x);
console.log(y[0]); // 21

// À partir d'un ArrayBuffer
const buffer = new ArrayBuffer(16);
const z = new Int32Array(buffer, 0, 4);

// À partir d'un itérable
const iterable = (function* () {
  yield* [1, 2, 3];
})();
const int32_from_iterable = new Int32Array(iterable);
// Int32Array[1, 2, 3]

Spécifications

Compatibilité des navigateurs

Notes de compatibilité

À partir d'ECMAScript 2015, le constructeur de Int32Array doit être appelé avec l'opérateur new. Utiliser le constructeur Int32Array comme une fonction, c'est-à-dire sans le mot-clé new, déclenchera désormais une exception TypeError.

const dv = Int32Array([1, 2, 3]);
// TypeError: calling a builtin Int32Array constructor
// without new is forbidden

const dv = new Int32Array([1, 2, 3]);

Voir aussi

• Prothèse d'émulation pour Int32Array avec la bibliothèque core-js
• Les tableaux typés en JavaScript
• ArrayBuffer
• DataView