CKTIS / JavaScript
DataView.prototype.getUint16() : lire un entier non signé sur 16 bits
Lisez deux octets d’une DataView comme un entier non signé sur 16 bits, dans l’ordre des octets spécifié par le format des données.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
view.getUint16(byteOffset)
view.getUint16(byteOffset, littleEndian)DataView.prototype.getUint16 est une méthode d’instance de DataView. Elle lit deux octets consécutifs sans modifier le tampon et renvoie une valeur de type Number, comprise entre 0 et 65535 inclus. Si le champ est signé, utilisez getInt16().
byteOffset compte les octets à partir du début de la vue, et non du début du tampon ni par unités de 16 bits. Aucun alignement n’est requis : un décalage impair est valide si les deux octets se trouvent dans la vue.
L’argument facultatif littleEndian est converti en booléen. true sélectionne l’ordre little-endian (octet de poids faible en premier) ; false ou l’omission de l’argument sélectionne l’ordre big-endian (octet de poids fort en premier). Choisissez l’ordre des octets d’après le format des données, et non d’après l’architecture du processeur.
Le décalage est converti en indice entier : undefined devient 0 et les valeurs fractionnaires sont tronquées vers zéro. Un résultat négatif déclenche une RangeError, tout comme une lecture dont les deux octets ne tiennent pas dans une vue valide. Une TypeError survient par exemple si this n’est pas une instance de DataView, si le tampon est détaché ou si la vue elle-même dépasse les limites du tampon après sa réduction.
Exemples
const bytes = new Uint8Array([0xaa, 0xbb, 0x12, 0x34, 0xcc]);
const view = new DataView(bytes.buffer, 1, 3);
console.log(view.getUint16(1));
console.log(view.getUint16(1, true));
try {
view.getUint16(2);
} catch (error) {
console.log(error.name);
}Résultat
4660 13330 RangeError
La vue commence à l’indice `1` du tampon : le décalage `1` dans la vue sélectionne donc `0x12` et `0x34`. La lecture par défaut renvoie `4660` et celle avec `true` renvoie `13330`. Au décalage `2`, il ne reste qu’un octet dans la vue : le code affiche donc `RangeError`.
Leçons associées
- JavaScript · Leçon 2 · Avancé · Version : 4