La vueDataView fournit une interface de bas niveau pour lire et écrire des données de différents types numériques dans un objetArrayBuffer, quel que soit le« boutisme » (endianness en anglais) de la plateforme.

Description

Boutisme

Les formats numériques sur plusieurs octets sont représentés différemment en mémoire selon l'architecture de la machine (voirla page du glossaire sur le boutisme pour plus d'explications). Les accesseursDataView permettent de contrôler explicitement la façon dont se fait l'accès aux données, quel que soit le boutisme de l'ordinateur.

const littleEndian = (() => {  const buffer = new ArrayBuffer(2);  new DataView(buffer).setInt16(0, 256, true /* littleEndian */);  // Int16Array utilise le boutisme de la plateforme  return new Int16Array(buffer)[0] === 256;})();console.log(littleEndian); // true ou false

Constructeur

DataView()

Crée un nouvel objetDataView.

Propriétés d'instances

Ces propriétés sont définies surDataView.prototype et partagées par toutes les instances deDataView.

DataView.prototype.buffer

Retourne l'objetArrayBuffer référencé par laDataView.

DataView.prototype.byteLength

Retourne la longueur (en octets) duDataView.

DataView.prototype.byteOffset

Retourne le décalage (en octets) duDataView depuis le début de son objetArrayBuffer.

DataView.prototype.constructor

La fonction constructeur qui a créé l'objet d'instance. Pour les instances deDataView, la valeur initiale est le constructeurDataView.

DataView.prototype[Symbol.toStringTag]

La valeur initiale de la propriété[Symbol.toStringTag] est la chaîne de caractères"DataView". Cette propriété est utilisée dansObject.prototype.toString().

Méthodes d'instances

DataView.prototype.getBigInt64()

Lit 8 octets à partir de l'encart d'octet défini de cetteDataView et les interprète comme un entier signé sur 64 bits.

DataView.prototype.getBigUint64()

Lit 8 octets à partir de l'encart d'octet défini de cetteDataView et les interprète comme un entier non-signé sur 64 bits.

DataView.prototype.getFloat16()

Lit 2 octets à partir de l'encart d'octet défini de cetteDataView et les interprète comme un nombre flottant sur 16 bits.

DataView.prototype.getFloat32()

Lit 4 octets à partir de l'encart d'octet défini de cetteDataView et les interprète comme un nombre flottant sur 32 bits.

DataView.prototype.getFloat64()

Lit 8 octets à partir de l'encart d'octet défini de cetteDataView et les interprète comme un nombre flottant sur 64 bits.

DataView.prototype.getInt16()

Lit 2 octets à partir de l'encart d'octet défini de cetteDataView et les interprète comme un entier signé sur 16 bits.

DataView.prototype.getInt32()

Lit 4 octets à partir de l'encart d'octet défini de cetteDataView et les interprète comme un entier signé sur 32 bits.

DataView.prototype.getInt8()

Lit 1 octet à l'encart d'octet défini de cetteDataView et l'interprète comme un entier signé sur 8 bits.

DataView.prototype.getUint16()

Lit 2 octets à partir de l'encart d'octet défini de cetteDataView et les interprète comme un entier non-signé sur 16 bits.

DataView.prototype.getUint32()

Lit 4 octets à partir de l'encart d'octet défini de cetteDataView et les interprète comme un entier non-signé sur 32 bits.

DataView.prototype.getUint8()

Lit 1 octet à l'encart d'octet défini de cetteDataView et l'interprète comme un entier non-signé sur 8 bits.

DataView.prototype.setBigInt64()

Prend unBigInt et l'enregistre comme un entier signé sur 64 bits dans les 8 octets à partir de l'encart d'octet défini de cetteDataView.

DataView.prototype.setBigUint64()

Prend unBigInt et l'enregistre comme un entier non-signé sur 64 bits dans les 8 octets à partir de l'encart d'octet défini de cetteDataView.

DataView.prototype.setFloat16()

Prend un nombre et l'enregistre comme un flottant sur 16 bits dans les 2 octets à partir de l'encart d'octet défini de cetteDataView.

DataView.prototype.setFloat32()

Prend un nombre et l'enregistre comme un flottant sur 32 bits dans les 4 octets à partir de l'encart d'octet défini de cetteDataView.

DataView.prototype.setFloat64()

Prend un nombre et l'enregistre comme un flottant sur 64 bits dans les 8 octets à partir de l'encart d'octet défini de cetteDataView.

DataView.prototype.setInt16()

Prend un nombre et l'enregistre comme un entier signé sur 16 bits dans les 2 octets à l'encart d'octet défini de cetteDataView.

DataView.prototype.setInt32()

Prend un nombre et l'enregistre comme un entier signé sur 32 bits dans les 4 octets à l'encart d'octet défini de cetteDataView.

DataView.prototype.setInt8()

Prend un nombre et l'enregistre comme un entier signé sur 8 bits dans l'octet à l'encart d'octet défini de cetteDataView.

DataView.prototype.setUint16()

Prend un nombre et l'enregistre comme un entier non-signé sur 16 bits dans les 2 octets à l'encart d'octet défini de cetteDataView.

DataView.prototype.setUint32()

Prend un nombre et l'enregistre comme un entier non-signé sur 32 bits dans les 4 octets à l'encart d'octet défini de cetteDataView.

DataView.prototype.setUint8()

Prend un nombre et l'enregistre comme un entier non-signé sur 8 bits dans l'octet à l'encart d'octet défini de cetteDataView.

Exemples

UtiliserDataView

const buffer = new ArrayBuffer(16);const view = new DataView(buffer, 0);view.setInt16(1, 42);view.getInt16(1); // 42

Spécifications

Compatibilité des navigateurs

Voir aussi

• Prothèse d'émulation pourDataView danscore-js^(angl.)
• L'objetArrayBuffer
• L'objetSharedArrayBuffer