DataView : méthode setBigInt64()
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 setBigInt64() des instances de DataView prend un BigInt et l'enregistre comme un entier signé sur 64 bits dans les 8 octets à partir du décalage d'octet défini de cette DataView. Il n'y a pas de contrainte d'alignement ; les valeurs sur plusieurs octets peuvent être enregistrées à 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 pouvant être stockée 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
setBigInt64(byteOffset, value)
setBigInt64(byteOffset, value, littleEndian)
Paramètres
byteOffset-
Le décalage, en octets, depuis le début de la vue où enregistrer la donnée.
value-
La valeur à enregistrer comme
BigInt. Pour savoir comment la valeur est encodée en octets, voir Encodage et normalisation des valeurs. littleEndianFacultatif-
Indique si les données sont stockées au format gros-boutiste ou petit-boutiste. Si la valeur est
falseouundefined, une valeur gros-boutiste est écrite.
Valeur de retour
Aucune (undefined).
Exceptions
RangeError-
Levée si le paramètre
byteOffsetest défini de façon à enregistrer au-delà de la fin de la vue.
Exemples
>Utiliser la méthode setBigInt64()
const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setBigInt64(0, 3n);
dataview.getBigInt64(1); // 768n
Spécifications
| Spécification |
|---|
| ECMAScript® 2027 Language Specification> # sec-dataview.prototype.setbigint64> |
Compatibilité des navigateurs
Voir aussi
- Le guide des tableaux typés JavaScript
- L'objet
DataView - L'objet
ArrayBuffer - L'objet
BigInt64Array