DataView.prototype.setBigUint64()
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 setBigUint64() permet d'enregister un entier non-signé sur 64 bits (type unsigned long long par analogie avec C) à l'octet indiqué par rapport au début de la DataView.
Exemple interactif
// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(16);
// Highest possible BigInt value that fits in an unsigned 64-bit integer
const max = 2n ** 64n - 1n;
const view = new DataView(buffer);
view.setBigUint64(1, max);
console.log(view.getBigUint64(1));
// Expected output: 18446744073709551615n
Syntaxe
dataview.setBigUint64(positionOctet, value [, littleEndian])
Paramètres
positionOctet-
La position, exprimée en nombre d'octets, à partir du début de la vue à laquelle enregistrer la donnée.
valeur-
La valeur à enregistrer
littleEndian-
Facultatif Indique si la donnée sur 64 bits est enregistrée dans l'ordre des octets de poids faibles. Si ce paramètre vaut
falseouundefined, l'ordre sera celui des octets de poids forts.
Valeur de retour
Erreurs renvoyées
RangeError-
Renvoyée si
positionOctetest tel que l'enregistrement sera fait en dehors de la vue.
Exemples
Utilisation de la méthode setBigUint64()
var buffer = new ArrayBuffer(8);
var dataview = new DataView(buffer);
dataview.setBigUint64(0, 3n);
dataview.getInt32(0); // 3n
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-dataview.prototype.setbiguint64 |
Compatibilité des navigateurs
Chargement…