i64: Wasm-Werttyp
Der i64-Werttyp speichert einen 64-Bit-Integer.
Syntax
;; Function returning an i64 constant
(func (result i64)
i64.const 9000000000
)
;; i64 parameter and local
(func (param $p i64) (local $tmp i64)
;; ...
)
;; Mutable i64 global
(global $count (mut i64) (i64.const 0))
Beschreibung
i64-Werte sind 64 Bit breit und weder von Natur aus signiert noch unsigniert. Jede Anweisung wählt ihre Interpretation: Signierte Varianten wie i64.div_s behandeln Operanden als Zweierkomplement, während unsignierte Varianten wie i64.div_u dies nicht tun. Operationen, deren Ergebnis unabhängig von der Signierung ist, wie etwa Addition, Subtraktion, Multiplikation und bitweise Operationen, haben eine einzige Anweisung.
i64 ist transparent: sein Bitmuster ist sichtbar, und i64-Werte können im linearen Speicher gespeichert werden.
i64-Integration mit JavaScript BigInt
Der Number-Typ von JavaScript kann den vollständigen i64-Bereich nicht verlustfrei darstellen, daher werden i64-Werte in BigInt-Werte (und umgekehrt) konvertiert, wenn sie die JavaScript-Grenze überschreiten; zum Beispiel beim Exportieren oder Importieren von Funktionen mit i64-Parametern oder Rückgabewerten.
Beim Exportieren einer Wasm-Funktion mit der Signatur: [i64] -> [i64], muss der Parameter als BigInt-Wert ausgedrückt werden:
const result = wasmInstance.exports.myFunc(42n);
console.log(result); // also a BigInt
Ein i64-Rückgabewert wird in JavaScript automatisch zu einem BigInt.
Beim Wechsel von JavaScript zu Wasm wird ein als i64-Argument übergebener BigInt auf 64 Bit gekürzt, modulo 2⁶⁴ umbrochen. Das Übergeben einer einfachen Number, wo ein i64 erwartet wird, führt zu einem TypeError.
Spezifikationen
| Spezifikation |
|---|
| WebAssembly Core Specification # number-types%E2%91%A0 |