Constructeur Uint16Array()
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 Uint16Array()
permet de créer un nouveau tableau typé Uint16Array
dont les éléments sont des nombres entiers non-signés, représentés sur 16 bits et utilisant le boutisme de la plateforme.
Syntaxe
new Uint16Array(); // apparu avec ES2017
new Uint16Array(longueur);
new Uint16Array(tableauType);
new Uint16Array(object);
new Uint16Array(buffer);
new Uint16Array(buffer, decalageOctets);
new Uint16Array(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 delongueur
multipliée parBYTES_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 nonbigint
(commeInt32Array
),tableauType
est copié dans un nouveau tableau typé et chaque valeur detableauType
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'argumenttableauType
. 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 argumentsdecalageOctets
etlongueur
, le constructeur crée une nouvelle vue sous la forme d'un tableau typé qui porte sur l'objetArrayBuffer
donné par le paramètrebuffer
. Les paramètresdecalageOctets
etlongueur
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 debuffer
qui sera vu ; si seullongueur
est absent, c'est toutbuffer
qui sera vu à partir dedecalageOctets
.
Description
Uint16Array()
permet de créer un nouveau tableau typé Uint16Array
dont les éléments sont des nombres entiers non-signés, représentés sur 16 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.
À partir d'ECMAScript 2015, le constructeur de Uint16Array
doit être appelé avec l'opérateur new
. Utiliser le constructeur Uint16Array
comme une fonction, c'est-à-dire sans le mot-clé new
, déclenchera désormais une exception TypeError
.
const dv = Uint16Array([1, 2, 3]);
// TypeError: calling a builtin Uint16Array constructor
// without new is forbidden
const dv = new Uint16Array([1, 2, 3]);
Exemples
Plusieurs façons de créer un objet Uint16Array
// À partir d'une longueur
const uint16 = new Uint16Array(2);
uint16[0] = 42;
console.log(uint16[0]); // 42
console.log(uint16.length); // 2
console.log(uint16.BYTES_PER_ELEMENT); // 2
// À partir d'un tableau
const arr = new Uint16Array([21, 31]);
console.log(arr[1]); // 31
// À partir d'un autre tableau typé
const x = new Uint16Array([21, 31]);
const y = new Uint16Array(x);
console.log(y[0]); // 21
// À partir d'un ArrayBuffer
const buffer = new ArrayBuffer(8);
const z = new Uint16Array(buffer, 0, 4);
// À partir d'un itérable
const iterable = (function* () {
yield* [1, 2, 3];
})();
const uint16_from_iterable = new Uint16Array(iterable);
// Uint16Array[1, 2, 3]
Spécifications
Specification |
---|
ECMAScript Language Specification # sec-typedarray-constructors |
Compatibilité des navigateurs
BCD tables only load in the browser