Constructeur Uint32Array()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Le constructeur Uint32Array() permet de créer un nouveau tableau typé Uint32Array dont les éléments sont des nombres entiers non-signés, représentés sur 32 bits et utilisant le boutisme de la plateforme. S'il est nécessaire de contrôler l'ordre des octets, on utilisera un objet DataView à la place. Lors de la construction, les éléments du tableau sont initialisés avec la valeur 0. Une fois le tableau construit, on peut faire référence aux éléments du tableau à l'aide des méthodes de l'objet ou en utilisant la notation avec les crochets et l'indice voulu.

Syntaxe

js
new Uint32Array(); // apparu avec ES2017
new Uint32Array(longueur);
new Uint32Array(tableauType);
new Uint32Array(object);

new Uint32Array(buffer);
new Uint32Array(buffer, decalageOctets);
new Uint32Array(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 Int32Array), 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 Uint32Array

js
// À partir d'une longueur
let uint32 = new Uint32Array(2);
uint32[0] = 42;
console.log(uint32[0]); // 42
console.log(uint32.length); // 2
console.log(uint32.BYTES_PER_ELEMENT); // 4

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

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

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

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

Spécifications

Specification
ECMAScript Language Specification
# sec-typedarray-constructors

Compatibilité des navigateurs

BCD tables only load in the browser

Notes de compatibilité

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

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

Voir aussi