Constructeur BigInt64Array()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨septembre 2021⁩.

Le constructeur BigInt64Array() permet de créer un nouveau tableau typé BigInt64Array dont les éléments sont des entiers signés sur 64 bits, 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 0n. 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

new BigInt64Array();
new BigInt64Array(longueur);
new BigInt64Array(tableauType);
new BigInt64Array(object);

new BigInt64Array(buffer);
new BigInt64Array(buffer, decalageOctets);
new BigInt64Array(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 type bigint (comme BigUInt64Array), 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 `BigInt64Array`

// À partir d'une longueur
const bigint64 = new BigInt64Array(2);
bigint64[0] = 42n;
console.log(bigint64[0]); // 42n
console.log(bigint64.length); // 2
console.log(bigint64.BYTES_PER_ELEMENT); // 8

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

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

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

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