diff options
Diffstat (limited to 'files/fr/web/javascript/reference/objets_globaux/dataview/getbigint64/index.html')
-rw-r--r-- | files/fr/web/javascript/reference/objets_globaux/dataview/getbigint64/index.html | 88 |
1 files changed, 88 insertions, 0 deletions
diff --git a/files/fr/web/javascript/reference/objets_globaux/dataview/getbigint64/index.html b/files/fr/web/javascript/reference/objets_globaux/dataview/getbigint64/index.html new file mode 100644 index 0000000000..b5d6e40180 --- /dev/null +++ b/files/fr/web/javascript/reference/objets_globaux/dataview/getbigint64/index.html @@ -0,0 +1,88 @@ +--- +title: DataView.prototype.getBigInt64() +slug: Web/JavaScript/Reference/Objets_globaux/DataView/getBigInt64 +tags: + - BigInt + - DataView + - JavaScript + - Méthode + - Prototype + - Reference + - TypedArrays +translation_of: Web/JavaScript/Reference/Global_Objects/DataView/getBigInt64 +--- +<div>{{JSRef}}</div> + +<p>La méthode <strong><code>getBigInt64()</code></strong> permet de lire un entier signé sur 64 bits (type <em>long long</em> par analogie avec C) à l'octet donné par rapport au début de {{jsxref("DataView")}}.</p> + +<div>{{EmbedInteractiveExample("pages/js/dataview-getbigint64.html")}}</div> + +<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox"><var>dataview</var>.getBigInt64(positionOctet [, littleEndian])</pre> + +<h3 id="Paramètres">Paramètres</h3> + +<dl> + <dt><code>positionOctet</code></dt> + <dd>La position, exprimée en nombre d'octets depuis le début de la vue, à laquelle lire les données.</dd> + <dt><code>littleEndian</code></dt> + <dd>{{optional_inline}} indique si la valeur sur 64 bits est enregistrée dans l'ordre des octets {{Glossary("Endianness", "de poids faible")}}. Si le paramètre vaut <code>false</code> ou <code>undefined</code>, la valeur sera lue dans l'ordre des octets de poids forts.</dd> +</dl> + +<h3 id="Valeur_de_retour">Valeur de retour</h3> + +<p>Une valeur {{jsxref("BigInt")}}</p> + +<h3 id="Erreurs_renvoyées">Erreurs renvoyées</h3> + +<dl> + <dt>{{jsxref("RangeError")}}</dt> + <dd>Renvoyée si <code>positionOctet</code> est tel qu'il est en dehors de la vue.</dd> +</dl> + +<h2 id="Description">Description</h2> + +<p>Il n'y a pas de contrainte d'alignement, les valeurs codées sur plusieurs octets peuvent être obtenues depuis n'importe quelle position.</p> + +<h2 id="Exemples">Exemples</h2> + +<h3 id="Utilisation_de_la_méthode_getBigInt64()">Utilisation de la méthode <code>getBigInt64()</code></h3> + +<pre class="brush:js">var buffer = new ArrayBuffer(8); +var dataview = new DataView(buffer); +dataview.getBigInt64(0); // 0n +</pre> + +<h2 id="Spécifications">Spécifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Spécification</th> + <th scope="col">État</th> + <th scope="col">Commentaires</th> + </tr> + <tr> + <td><a href="https://tc39.github.io/proposal-bigint/#sec-dataview.prototype.getbigint64">Proposition pour <code>DataView.prototype.getBigInt64()</code></a></td> + <td></td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden">Ce tableau de compatibilité a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une <em>pull request</em> sur <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</div> + +<p>{{Compat("javascript.builtins.DataView.getBigInt64")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>{{jsxref("DataView")}}</li> + <li>{{jsxref("ArrayBuffer")}}</li> + <li>{{jsxref("BigInt")}}</li> +</ul> |