DataView : méthode getBigUint64()
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.
La méthode getBigUint64() 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 non-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 non-signé sur 64 bits
const max = 2n ** 64n - 1n;
const view = new DataView(buffer);
view.setBigUint64(1, max);
console.log(view.getBigUint64(1));
// Résultat attendu : 18446744073709551615n
Syntaxe
getBigUint64(byteOffset)
getBigUint64(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 0 et 264-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 getBigUint64()
const { buffer } = new Uint8Array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]);
const dataview = new DataView(buffer);
console.log(dataview.getBigUint64(1)); // 72623859790382856n
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-dataview.prototype.getbiguint64 |
Compatibilité des navigateurs
Voir aussi
- Le guide des tableaux typés JavaScript
- L'objet
DataView - L'objet
ArrayBuffer - L'objet
BigUint64Array