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 (.) enthalten sein.

Typ

[input1, input2] -> [output]

input1

Der erste Eingabewert.

input2

Der zweite Eingabewert.

output

Der Ausgabewert.

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

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

Binäre Kodierung

Beispiele

SIMD max Beispiel

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

JavaScript

In unserem Script greifen wir auf ein <p>-Element zu, an das wir unser Ergebnis ausgeben werden, und definieren dann ein Objekt zum Importieren in Wasm, das eine einzelne Funktion enthält, die einen Wert an das <p>-Element ausgibt. Wir kompilieren und instanziieren dann unser Wasm-Modul mit der Methode WebAssembly.instantiateStreaming() und importieren das Objekt dabei.

<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-output()-Funktion und stellen sicher, dass sie einen f32-Parameter hat. Dann deklarieren wir zwei SIMD f32x4-Werte und verwenden f32x4.max, um einen neuen f32x4-Wert zurückzugeben, der in jedem Fall den höheren Lane-Wert aus den beiden Eingaben enthält. Schließlich extrahieren wir den in Lane 3 gespeicherten Wert des Ausgabewertes mit der extract_lane-Instruktion und geben ihn durch Aufruf der importierten output()-Funktion an das DOM aus.

(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

Die Ausgabe 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 ist als 108, hat der neue f32x4-Wert, der von der f32x4.max-Instruktion ausgegeben wird, 1000 in Lane 3 gesetzt, den wir dann extrahieren und an das DOM ausgeben.

Siehe auch

• max_s
• max_u