max: Wasm Text-Instruktion

Probieren Sie es aus

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

    f32.max ;; calculate the higher number
    call $log ;; log the result
  )
  (start $main)
)

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

Syntax

value_type.max

value_type

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

• f32
• f64
• v128-Interpretationen:
  • f32x4
  • f64x2

max

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

Typ

[input1, input2] -> [output]

input1

Der erste Eingabewert.

input2

Der zweite Eingabewert.

output

Der Ausgabewert.

Für ein nicht-SIMD max sind die Eingaben grundlegende numerische Werte wie 3.0 oder 3.5, und das output wird der größere von input1 und input2 sein.

Für ein SIMD max sind die Eingaben v128-Wertinterpretationen, beispielsweise f32x4 2.0 30 86.9 120. Jede Lane des Outputs, die auf den Stapel geschoben wird, ist die größere der entsprechenden Lanes in den Eingabewerten.

Binäre Kodierung

Beispiele

SIMD max Beispiel

In diesem Beispiel zeigen wir, wie max verwendet wird, um den größeren Wert des gleichen Lane-Index aus zwei SIMD-Werten zu ermitteln.

JavaScript

In unserem Skript holen wir eine Referenz zu einem <p>-Element, das wir verwenden, um unser Ergebnis auszugeben. Anschließend definieren wir 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 unser Wasm-Modul mithilfe der WebAssembly.instantiateStreaming()-Methode 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 f32-Parameter hat. Wir deklarieren dann zwei SIMD f32x4-Werte und verwenden f32x4.max, um einen neuen f32x4-Wert zurückzugeben, der in jedem Fall den höheren Lane-Wert der beiden Eingaben enthält. Schließlich extrahieren wir den in Lane 3 des Ausgangswerts gespeicherten Wert mithilfe 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 f32)))

  (func $main
    ;; load two SIMD values onto the stack
    v128.const f32x4 20 0 1015 1000
    v128.const f32x4 4 38 15 108

    ;; Return a new f32x4 containing the highest lane value in each case
    f32x4.max
    f32x4.extract_lane 3 ;; Extract a value from the result

    call $output
  )

  (start $main)
)

Ergebnis

Das Ergebnis ist wie folgt:

Das Ergebnis ist 1000. Dies liegt daran, dass der in Lane 3 des ersten Eingabewertes gespeicherte Wert 1000 ist und der in Lane 3 des zweiten Eingabewertes gespeicherte Wert 108. Da 1000 größer als 108 ist, hat der neue durch die f32x4.max-Instruktion ausgegebene f32x4-Wert 1000 in Lane 3 gesetzt, den wir dann extrahieren und an das DOM ausgeben.

Siehe auch

• max_s
• max_u