DataView : méthode setUint16()
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 juillet 2015.
La méthode setUint16() des instances de DataView prend un nombre et l'enregistre comme un entier non-signé sur 16 bits dans les 2 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);
const view = new DataView(buffer);
view.setUint16(1, 65535); // Valeur maximale pour un entier non-signé sur 16 bits
console.log(view.getUint16(1));
// Résultat attendu : 65535
Syntaxe
setUint16(byteOffset, value)
setUint16(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 setUint16()
const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setUint16(0, 3);
dataview.getUint16(0); // 768
Spécifications
| Spécification |
|---|
| ECMAScript® 2027 Language Specification> # sec-dataview.prototype.setuint16> |
Compatibilité des navigateurs
Voir aussi
- Le guide des tableaux typés JavaScript
- L'objet
DataView - L'objet
ArrayBuffer - L'objet
Uint16Array