min: 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.min ;; calculate the lower number
    call $log ;; log the result
  )
  (start $main)
)

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

Syntax

value_type.min

value_type

Der Typ des Wertes, auf den die Anweisung angewendet wird. Die folgenden Typen unterstützen min:

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

min

Die min Anweisung. Muss immer nach dem value_type und einem Punkt (.) eingeschlossen sein.

Typ

[input1, input2] -> [output]

input1

Der erste Eingabewert.

input2

Der zweite Eingabewert.

output

Der Ausgabewert.

Für ein nicht-SIMD min sind die Eingaben grundlegende numerische Werte wie 3.0 oder 3.5, und der output ist der kleinere von input1 und input2.

Für ein SIMD min sind die Eingaben v128 Wertinterpretationen, beispielsweise f32x4 2.0 30 86.9 120. Jede Lane des zur Stack gepushten Outputs ist der kleinere der entsprechenden Lanes in den Eingabewerten.

Binäre Kodierung

Beispiele

SIMD min Beispiel

In diesem Beispiel demonstrieren wir die Verwendung von min, um den kleineren Wert des gleichen Lane-Index aus zwei SIMD-Werten zurückzugeben.

JavaScript

In unserem Skript erhalten wir eine Referenz zu einem <p>-Element, zu dem wir unser Ergebnis ausgeben werden, und definieren dann ein Objekt für den Import in Wasm, das eine einzelne Funktion enthält, die einen Wert in das Ausgabeelement <p> schreibt. Danach kompilieren und instanziieren wir unser Wasm-Modul mit der Methode WebAssembly.instantiateStreaming(), wobei wir das Objekt im Prozess 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 zunächst die JavaScript-Funktion output() und stellen sicher, dass sie einen f32-Parameter hat. Dann deklarieren wir zwei SIMD f32x4 Werte und verwenden f32x4.min, um einen neuen f32x4 Wert zurückzugeben, der den kleineren Lanes-Wert aus den beiden Eingaben in jedem Fall enthält. Schließlich extrahieren wir den in Lane 3 des Ausgabe-Wertes gespeicherten Wert mit der extract_lane Anweisung und geben ihn durch Aufrufen 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.min
    f32x4.extract_lane 3 ;; Extract a value from the result

    call $output
  )

  (start $main)
)

Ergebnis

Die Ausgabe ist wie folgt:

Das Ergebnis ist 108. 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 ist. Da 108 kleiner als 1000 ist, hat der neue f32x4 Wert, der von der f32x4.min Anweisung ausgegeben wird, 108 in Lane 3 gesetzt, den wir dann extrahieren und an das DOM ausgeben.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• min_s
• min_u