DataView : méthode getBigInt64()
Baseline
Large disponibilité
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.
La méthode getBigInt64() des instances de DataView lit 8 octets à partir du décalage d'octet défini de cette DataView et les interprète comme un entier signé sur 64 bits. Il n'y a pas de contrainte d'alignement ; les valeurs sur plusieurs octets peuvent être obtenues depuis n'importe quel décalage valide.
Exemple interactif
// Créer un ArrayBuffer avec une taille en octets
const buffer = new ArrayBuffer(16);
// Valeur BigInt maximale possible qui tient dans un entier signé sur 64 bits
const max = 2n ** (64n - 1n) - 1n;
const view = new DataView(buffer);
view.setBigInt64(1, max);
console.log(view.getBigInt64(1));
// Résultat attendu : 9223372036854775807n
Syntaxe
getBigInt64(byteOffset)
getBigInt64(byteOffset, littleEndian)
Paramètres
byteOffset-
La position, exprimée en nombre d'octets depuis le début de la vue, à laquelle lire les données.
littleEndianFacultatif-
Indique si la valeur sur 64 bits est enregistrée dans l'ordre des octets gros-boutiste ou petit-boutiste. Si le paramètre vaut
falseouundefined, la valeur gros-boutiste sera lue.
Valeur de retour
Une valeur BigInt comprise entre -263 et 263-1 inclus.
Exceptions
RangeError-
Levée si le paramètre
byteOffsetest défini de façon à lire au-delà de la fin de la vue.
Exemples
>Utiliser la méthode getBigInt64()
const { buffer } = new Uint8Array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]);
const dataview = new DataView(buffer);
console.log(dataview.getBigInt64(1)); // 72623859790382856n
Spécifications
| Spécification |
|---|
| ECMAScript® 2027 Language Specification> # sec-dataview.prototype.getbigint64> |
Compatibilité des navigateurs
Voir aussi
- Le guide des tableaux typés JavaScript
- L'objet
DataView - L'objet
ArrayBuffer - L'objet
BigInt64Array