add: Wasm-Textanweisung

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 (.) stehen.

Typ

[input1, input2] -> [output]

input1

Der erste zu addierende Wert.

input2

Der zweite zu addierende Wert.

output

Die Summe der beiden Eingabewerte.

Für eine nicht-SIMD add sind dies grundlegende numerische Werte wie 3 oder 3.5.

Für eine SIMD add sind dies v128 Wertinterpretationen, zum Beispiel f32x4 0x9 0xa 0xb 0xc. Jeder Lane der Ausgabe, die auf den Stack gelegt wird, ist die Addition der entsprechenden Lanes in den Eingabewerten.

Binärcode

Beispiele

SIMD Addition

In diesem Beispiel demonstrieren wir das Addieren zweier SIMD-Werte und das Ausgeben eines der Lane-Werte.

JavaScript

In unserem Skript holen wir uns eine Referenz auf ein <p> Element, in das wir unser Ergebnis ausgeben werden, dann definieren wir ein Objekt zum Importieren in Wasm, das eine einzige Funktion enthält, die einen Wert in das Ausgabe-<p> schreibt. Wir kompilieren und instanziieren dann unser Wasm-Modul mit der Methode WebAssembly.instantiateStreaming(), wobei wir das Objekt 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 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 der Summe gespeicherten Wert mit der extract_lane Anweisung 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, da der Wert, der in Lane 3 jedes der Eingabewerte gespeichert ist, 12 ist. Einmal addiert, enthält Lane 3 des Ausgabewertes den Wert 24.