max: Wasm numerische Anweisung

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 Typ des Wertes, auf dem die Anweisung ausgeführt wird. Die folgenden Typen unterstützen max:

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

max

Die max Anweisung. Muss immer nach dem value_type und einem Punkt (.) enthalten sein.

Typ

[input1, input2] -> [output]

input1

Der erste Eingabewert.

input2

Der zweite Eingabewert.

output

Der Ausgabewert.

Bei einem nicht-SIMD max sind die Eingaben einfache numerische Werte wie 3.0 oder 3.5, und der output wird der größere von input1 und input2 sein.

Bei einem SIMD max sind die Eingaben v128 Wertinterpretationen, zum Beispiel f32x4 2.0 30 86.9 120. Jede Spur des Outputs, der auf den Stapel geschoben wird, ist die größere der entsprechenden Spuren in den Eingabewerten.

Binäre Kodierung

Beispiele

SIMD max Beispiel

In diesem Beispiel demonstrieren wir die Verwendung von max, um den größeren Wert desselben Spurindex aus zwei SIMD-Werten zurückzugeben.

JavaScript

In unserem Skript holen wir eine Referenz zu einem <p> Element, in das wir unser Ergebnis ausgeben werden. Dann definieren wir ein Objekt zum Import in Wasm, das eine einzelne Funktion enthält, die einen Wert in das <p> ausgibt. Anschließend kompilieren und instanziieren wir 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 f32 Parameter hat. Dann deklarieren wir zwei SIMD f32x4 Werte und nutzen f32x4.max, um einen neuen f32x4 Wert zurückzugeben, der in jedem Fall den höheren Spurwert der beiden Eingaben enthält. Schließlich extrahieren wir mit der Anweisung extract_lane den Wert, der in Spur 3 des Ausgabewertes gespeichert ist, und geben ihn an das DOM aus, indem wir die importierte Funktion output() 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 Spur 3 des ersten Eingabewertes gespeicherte Wert 1000 ist, und der in Spur 3 des zweiten Eingabewertes gespeicherte Wert 108 ist. Da 1000 größer als 108 ist, hat der neue f32x4 Wert, der durch die f32x4.max Anweisung ausgegeben wird, 1000 in Spur 3 gesetzt, den wir dann extrahieren und an das DOM ausgeben.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• max_s
• max_u