Constructeur BigInt64Array()
============================

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
-------


```js
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`


```js
// À 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]
```

Spécifications
--------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-typedarray-constructors |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Les tableaux typés en JavaScript
* `BigUint64Array`
* `DataView`