add: Wasm Text-Anweisung

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 Anweisung ausgeführt wird. Die folgenden Typen unterstützen add:

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

add

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

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 handelt es sich um grundlegende numerische Werte wie 3 oder 3.5.

Bei einem SIMD-add sind dies v128-Werteinterpretationen, zum Beispiel f32x4 0x9 0xa 0xb 0xc. Jedes Segment der Ausgabe, das auf den Stack geschoben wird, ist die Addition der entsprechenden Segmente in den Eingabewerten.

Binäre Kodierung

Beispiele

SIMD-Addition

In diesem Beispiel demonstrieren wir das Addieren von zwei SIMD-Werten und das Ausgeben eines der Segmentwerte.

JavaScript

In unserem Skript greifen wir auf ein <p>-Element zu, in das wir unser Ergebnis ausgeben werden, und definieren dann ein Objekt, das in Wasm importiert wird und eine einzige Funktion enthält, die einen Wert in das Ausgabefeld <p> schreibt. Wir kompilieren und instanziieren dann unser Wasm-Modul mithilfe 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 deklariert. Dann deklarieren wir zwei SIMD-i32x4-Werte und addieren sie mit i32x4.add. Schließlich extrahieren wir den Wert, der im Segment 3 der Summe der Addition gespeichert ist, mit der Anweisung extract_lane 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

Das Ergebnis ist wie folgt:

Das Ergebnis ist 24, da der im Segment 3 gespeicherte Wert jedes der Eingabewerte 12 ist. Sobald sie addiert werden, enthält das Ausgabewerts-Segment 3 den Wert 24.