eq: Wasm-Textinstruktion

Die eq-Instruktion, kurz für equal, prüft, ob zwei Zahlen gleich sind.

Probieren Sie es aus

(module
 (import "env" "log_bool" (func $log_bool (param i32)))
 (func $main
 ;; load `10` and `2` onto the stack
 i32.const 10
 i32.const 2
 i32.eq ;; check if `10` is equal to `2`
 call $log_bool ;; log the result
 )
 (start $main)
)

const url = "{%wasm-url%}";
function log_bool(value) {
 console.log(Boolean(value));
 // Expected output: false
}
await WebAssembly.instantiateStreaming(fetch(url), {
 env: { log_bool },
});

Syntax

value_type.eq

value_type

Der Werttyp, auf dem die Instruktion ausgeführt wird. Die folgenden Typen unterstützen eq:

• i32
• i64
• f32
• f64
• v128-Interpretationen:
  • i8x16
  • i16x8
  • i32x4
  • i64x2
  • f32x4
  • f64x2

eq

Die eq-Instruktion. Muss immer nach dem value_type und einem Punkt (.) eingefügt werden.

Typ

[input1, input2] -> [output]

input1

Der erste Eingabewert.

input2

Der zweite Eingabewert.

output

Der Ausgabewert, der ein Ganzzahltyp sein wird.

Für eine nicht-SIMD eq-Instruktion werden die Eingaben grundlegende numerische Werte wie 1 oder 3.5 sein. Wenn die Eingabewerte gleich sind, wird 1 auf den Stapel geschoben, andernfalls wird 0 auf den Stapel geschoben.

Für eine SIMD eq-Instruktion werden die Eingaben v128-Wertinterpretationen sein, zum Beispiel f32x4 0x9 0xa 0xb 0xc. Jede Spur der Ausgabe, die auf den Stapel geschoben wird, ist eine 1 oder 0, die die Gleichheit der entsprechenden Spuren in den Eingabewerten anzeigt.

Binärcodierung

Beispiele

SIMD eq Beispiel

In diesem Beispiel demonstrieren wir die Verwendung von eq, um zu testen, ob ein Spurwert aus zwei separaten SIMD-Werten gleich ist.

JavaScript

In unserem Skript greifen wir auf ein <p>-Element zu, an das wir unser Ergebnis ausgeben werden, und definieren ein Objekt für den Import in Wasm, das eine einzelne Funktion enthält, die einen Wert an das Ausgabe-<p> schreibt. Wir kompilieren und instanziieren dann unser Wasm-Modul mit der Methode WebAssembly.instantiateStreaming(), indem wir das Objekt dabei importieren.

<p></p>

const outputElem = document.querySelector("p");
const obj = {
 output(val) {
 outputElem.textContent += val;
 },
};
WebAssembly.instantiateStreaming(fetch("{%wasm-url%}"), {
 obj,
});

Wasm

In unserem Wasm-Modul importieren wir zuerst die JavaScript-Funktion output(), wobei wir darauf achten, anzugeben, dass sie einen i32-Parameter hat. Wir deklarieren dann zwei SIMD i16x8-Werte und prüfen, ob sie mit i16x8.eq gleich sind. Schließlich extrahieren wir den in Spur 7 des Ausgabewertes gespeicherten Wert mit der Instruktion extract_lane_s und geben ihn an das DOM aus, indem wir die importierte Funktion output() aufrufen.

(module
 ;; Import output function
 (import "obj" "output" (func $output (param i32)))
 (func $main
 ;; load two SIMD values onto the stack
 v128.const i16x8 20 12 15 100 9 8 -7 8
 v128.const i16x8 20 12 15 100 9 8 -7 4
 i16x8.eq ;; check whether the values are equal
 i16x8.extract_lane_s 7 ;; Extract a value from the result
 call $output
 )
 (start $main)
)

Ergebnis

Die Ausgabe ist wie folgt:

Das Ergebnis ist 0, da die Werte, die in Spur 7 der beiden Eingabewerte gespeichert sind, nicht gleich sind.