BigInt64Array
=============

Le tableau typé **`BigInt64Array`** permet de représenter un tableau d'entiers signés représentés sur 64 bits, où l'ordre des octets correspond à celui de la plateforme utilisée. Si on souhaite contrôler l'ordre des octets utilisé (le « boutisme »), on utilisera un objet `DataView` à la place. Les éléments du tableau sont initialisés à `0n`. Une fois que le tableau est construit, on peut manipuler ses différents éléments grâce aux méthodes de l'objet ou grâce à la notation usuelle (avec les crochets).

Syntaxe
-------


```js
new BigInt64Array();
new BigInt64Array(longueur);
new BigInt64Array(tableauTypé);
new BigInt64Array(objet);
new BigInt64Array(tampon [, décalage [, longueur]]);
```


Pour plus d'informations sur la syntaxe du constructeur et le rôle des différents paramètres, voir la page *TypedArray*.

Propriétés
----------

`BigInt64Array.BYTES_PER_ELEMENT`

Cette propriété renvoie un nombre correspondant à la quantité d'octets pour un élément du tableau. Dans le cas d'`BigInt64Array`, ce sera `8`.

`BigInt64Array.length`

La propriété de longueur statique qui vaut 3. Pour connaître le nombre d'élément, voir `BigInt64Array.prototype.length`.

`BigInt64Array.name`

Cette propriété renvoie la chaîne de caractères correspondant au nom du constructeur. Pour `BigInt64Array` ce sera : "BigInt64Array".

`BigInt64Array.prototype` (en-US)

Le prototype des objets *TypedArray*.

Méthodes
--------

`BigInt64Array.from()`

Cette méthode permet de créer un nouveau tableau typé `BigInt64Array` à partir d'un itérable ou d'un objet semblable à un tableau. Voir aussi `Array.from()`.

`BigInt64Array.of()`

Cette méthode permet de créer un nouvel objet `BigInt64Array` à partir d'un nombre d'arguments variables. Voir aussi `Array.of()`.

Prototype `BigInt64Array`
-------------------------

Tous les objets `BigInt64Array` héritent de `%TypedArray%.prototype` (en-US).

### Propriétés

`BigInt64Array.prototype.constructor`

Cette propriété renvoie la fonction qui a créé l'instance du prototype. Par défaut, ce sera le constructeur `BigInt64Array`.

`BigInt64Array.prototype.buffer` Lecture seule 

Cette propriété renvoie l'objet `ArrayBuffer` référencé par l'objet `BigInt64Array` Elle est déterminée lors de la construction et est accessible uniquement en **lecture seule**.

`BigInt64Array.prototype.byteLength` Lecture seule 

Cette propriété renvoie la longueur, exprimée en octets, de l'objet `BigInt64Array` à partir du début de l'objet `ArrayBuffer` correspondant. Elle est déterminée lors de la construction et est accessible uniquement en **lecture seule**.

`BigInt64Array.prototype.byteOffset` Lecture seule 

Cette propriété renvoie le décalage, en nombre d'octets, entre le début du tableau typé courant et du début du `ArrayBuffer` correspondant. Elle est déterminée lors de la construction et est accessible uniquement en **lecture seule**.

`BigInt64Array.prototype.length` Lecture seule 

Cette propriété renvoie le nombre d'éléments contenus dans le tableau `BigInt64Array`. Elle est déterminée lors de la construction et est accessible uniquement en **lecture seule**.

### Méthodes

`BigInt64Array.prototype.copyWithin()`

Copie une suite d'éléments d'un tableau dans le tableau. Voir également `Array.prototype.copyWithin()`.

`BigInt64Array.prototype.entries()`

Renvoie un nouvel objet `Array Iterator` qui contient les paires clé/valeur pour chaque indice du tableau. Voir également `Array.prototype.entries()`.

`BigInt64Array.prototype.every()`

Teste si l'ensemble des éléments du tableau remplissent une certaine condition donnée par une fonction de test. Voir également `Array.prototype.every()`.

`BigInt64Array.prototype.fill()`

Remplit les éléments d'un tableau avec une certaine valeur pour les éléments compris entre un indice de début et un indice de fin. Voir également `Array.prototype.fill()`.

`BigInt64Array.prototype.filter()`

Crée un nouveau tableau dont tous les éléments proviennent de ce tableau et respectent une condition fournie par une fonction de test. Voir également `Array.prototype.filter()`.

`BigInt64Array.prototype.find()`

Renvoie une valeur trouvée dans le tableau s'il existe un élément du tableau qui satisfait une condition fournie par une fonction de test, s'il n'y a pas de tel élément `undefined` sera renvoyé. Voir également `Array.prototype.find()`.

`BigInt64Array.prototype.findIndex()`

Renvoie l'indice d'un élément qui satisfait une condition fournie par une fonction de test, si aucun élément ne remplit la condition -1 sera renvoyé. Voir également `Array.prototype.findIndex()`.

`BigInt64Array.prototype.forEach()`

Appelle une fonction pour chacun des élément du tableau. Voir également `Array.prototype.forEach()`.

`BigInt64Array.prototype.includes()`

Détermine si le tableau typé contient un élément donné. Cette méthode renvoie `true` ou `false` selon le cas de figure. Voir également `Array.prototype.includes()`.

`BigInt64Array.prototype.indexOf()`

Renvoie le premier indice (le plus petit) d'un élément du tableau qui est égal à la valeur fournie. Si aucun élément ne correspond, la valeur -1 sera renvoyée. Voir également `Array.prototype.indexOf()`.

`BigInt64Array.prototype.join()`

Fusionne l'ensemble des éléments du tableau en une chaîne de caractères. Voir également `Array.prototype.join()`.

`BigInt64Array.prototype.keys()`

Renvoie un nouvel objet `Array Iterator` qui contient les clés de chaque indice du tableau. Voir également `Array.prototype.keys()`.

`BigInt64Array.prototype.lastIndexOf()`

Renvoie le dernier indice (le plus élevé) d'un élément du tableau qui est égal à la valeur fournie. Si aucun élément ne correspond, la valeur -1 sera renvoyée. Voir également `Array.prototype.lastIndexOf()`.

`BigInt64Array.prototype.map()`

Crée un nouveau tableau dont les éléments sont les images des éléments du tableau courant par une fonction donnée. Voir également `Array.prototype.map()`.

`BigInt64Array.prototype.reduce()`

Applique une fonction sur un accumulateur et chaque élément du tableau (de gauche à droite) afin de réduire le tableau en une seule valeur. Voir également `Array.prototype.reduce()`.

`BigInt64Array.prototype.reduceRight()`

Applique une fonction sur un accumulateur et chaque élément du tableau (de droite à gauche) afin de réduire le tableau en une seule valeur. Voir également `Array.prototype.reduceRight()`.

`BigInt64Array.prototype.reverse()`

Inverse l'ordre des éléments d'un tableau. Le premier élément du tableau devient le dernier et le dernier devient le premier (et ainsi de suite). Voir également `Array.prototype.reverse()`.

`BigInt64Array.prototype.set()`

Enregistre plusieurs valeurs dans le tableau typé à partir de valeurs d'un autre tableau.

`BigInt64Array.prototype.slice()`

Extrait un fragment d'un tableau et renvoie ce fragment. Voir également `Array.prototype.slice()`.

`BigInt64Array.prototype.some()`

Renvoie `true` si au moins un des éléments remplit une condition donnée par une fonction de test. Voir également `Array.prototype.some()`.

`BigInt64Array.prototype.sort()`

Trie les éléments du tableau et renvoie ce tableau. Voir également `Array.prototype.sort()`.

`BigInt64Array.prototype.subarray()`

Renvoie un nouvel objet `BigInt64Array` qui est le fragment du tableau courant, entre les indices de début et de fin donnés.

`BigInt64Array.prototype.values()`

Renvoie un nouvel objet `Array Iterator` qui contient les valeurs correspondantes à chaque indice du tableau. Voir également `Array.prototype.values()`.

`BigInt64Array.prototype.toLocaleString()`

Renvoie une chaîne de caractères localisée qui représente le tableau et ses éléments. Voir également `Array.prototype.toLocaleString()`.

`BigInt64Array.prototype.toString()`

Renvoie une chaîne de caractère qui représente le tableau et ses éléments. Voir également `Array.prototype.toString()`.

`BigInt64Array.prototype[@@iterator]()`

Renvoie un nouvel objet `Array Iterator` qui contient les valeurs correspondantes à chaque indice du tableau.

Exemples
--------

Différentes façons de créer un objet `BigInt64Array` :


```js
// Construction à partir d'une longueur
var bigInt64 = new BigInt64Array(2);
bigInt64[0] = 42n;
console.log(bigInt64[0]); // 42n
console.log(bigInt64.length); // 2
console.log(bigInt64.BYTES\_PER\_ELEMENT); // 8

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

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

// Construction à partir d'un ArrayBuffer
var buffer = new ArrayBuffer(32);
var z = new BigInt64Array(buffer, 0, 4);

// Construction à partir d'un itérable
var iterable = (function\* () {
  yield\* [1n, 2n, 3n];
})();
var BigInt64 = new BigInt64Array(iterable);
// BigInt64Array[1n, 2n, 3n]
```

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

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

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`