add: Wasm-Zahlenoperation

Probieren Sie es aus

(module
  (import "console" "log" (func $log (param i32)))
  (func $main
    ;; load `10` and `3` onto the stack
    i32.const 10
    i32.const 3

    i32.add ;; add up both numbers
    call $log ;; log the result
  )
  (start $main)
)

const url = "{%wasm-url%}";
await WebAssembly.instantiateStreaming(fetch(url), { console });

Syntax

value_type.add

value_type

Der Typ des Wertes, auf dem die Instruktion ausgeführt wird. Die folgenden Typen unterstützen add:

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

add

Die add-Instruktion. Muss immer nach dem value_type und einem Punkt (.) enthalten sein.

Typ

[input1, input2] -> [output]

input1

Der erste Wert, der addiert werden soll.

input2

Der zweite Wert, der addiert werden soll.

output

Die Summe der beiden Eingabewerte.

Bei einem nicht-SIMD add sind dies einfache numerische Werte wie 3 oder 3.5.

Bei einem SIMD add sind dies v128 Wertinterpretationen, zum Beispiel f32x4 0x9 0xa 0xb 0xc. Jede Lane des Ergebnisses, das auf den Stack geschoben wird, ist die Summe der entsprechenden Lanes in den Eingabewerten.

Binärcode

Beispiele

SIMD-Addition

In diesem Beispiel zeigen wir die Addition von zwei SIMD-Werten und die Ausgabe eines der Lane-Werte.

JavaScript

In unserem Skript holen wir eine Referenz zu einem <p>-Element, in das wir unser Ergebnis ausgeben, und definieren dann 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() und importieren dabei das Objekt.

<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 sicherstellen, dass sie einen i32-Parameter hat. Dann deklarieren wir zwei SIMD-i32x4-Werte und addieren sie mit i32x4.add. Schließlich extrahieren wir den in Lane 3 gespeicherten Wert der Summe der Addition mit der extract_lane-Instruktion und geben ihn an das DOM aus, indem wir die importierte output()-Funktion aufrufen.

(module
  ;; Import output function
  (import "obj" "output" (func $output (param i32)))

  (func $main
    ;; load two SIMD values onto the stack
    v128.const i32x4 9 10 11 12
    v128.const i32x4 9 10 11 12

    i32x4.add ;; add the two values
    i32x4.extract_lane 3 ;; Extract a value from the result

    call $output
  )

  (start $main)
)

Ergebnis

Die Ausgabe ist wie folgt:

Das Ergebnis ist 24, weil der in Lane 3 gespeicherte Wert jedes der Eingabewerte 12 ist. Nach der Addition enthält Lane 3 des Ausgabewerts den Wert 24.

Spezifikationen

Browser-Kompatibilität