sqrt: Wasm numerische Anweisung

Probieren Sie es aus

(module
  (import "console" "log" (func $log (param f32)))
  (func $main

    f32.const 2 ;; load a number onto the stack
    f32.sqrt ;; calculate the square root
    call $log ;; log the result

  )
  (start $main)
)

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

Syntax

value_type.sqrt

value_type

Der Typ des Wertes, auf dem die Anweisung ausgeführt wird. Die folgenden Typen unterstützen sqrt:

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

sqrt

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

Typ

[input] -> [output]

input

Der Eingabewert.

output

Der Ausgabewert. Erfolgreiche Ergebnisse werden nur für positive Zahlen zurückgegeben; der Versuch, die Quadratwurzel einer negativen Zahl zu berechnen, ergibt einen Ausgabewert von NaN.

Für eine nicht-SIMD-sqrt sind dies einfache numerische Werte wie 3.5 oder 9.

Für eine SIMD-sqrt sind dies v128-Wertinterpretationen, zum Beispiel f32x4 9 3.8 -16 101. Jede Lane des Outputs, das auf den Stack geschoben wird, enthält die Quadratwurzel der entsprechenden Lane im Eingabewert.

Binäre Kodierung

Beispiele

SIMD sqrt Nutzung

In diesem Beispiel demonstrieren wir die Verwendung von sqrt, um die Quadratwurzeln aller Spur-Inhalte eines SIMD-Wertes zu berechnen.

JavaScript

In unserem Skript greifen wir auf ein <p>-Element zu, auf das wir unser Ergebnis ausgeben werden. Dann definieren wir ein Objekt zur Importierung in Wasm, das eine einzelne Funktion enthält, die einen Wert an das <p> ausgibt. Wir kompilieren und instanziieren dann unser Wasm-Modul mit 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-output()-Funktion und stellen sicher, dass sie einen f64-Parameter deklariert. Dann deklarieren wir einen SIMD-f64x2-Wert und verwenden f64x2.sqrt, um die Quadratwurzeln aller Lanes zu berechnen. Schließlich extrahieren wir den Wert, der in Lane 1 des Output-Wertes gespeichert ist, mit der extract_lane-Anweisung und geben ihn über den Aufruf der importierten output()-Funktion an das DOM aus.

(module
  ;; Import output function
  (import "obj" "output" (func $output (param f64)))

  (func $main
    ;; load a SIMD value onto the stack
    v128.const f64x2 811.5 9

    f64x2.sqrt ;; output all square roots in a new f64x2 value
    f64x2.extract_lane 0 ;; Extract a value from the result
    call $output
  )

  (start $main)
)

Ergebnis

Die Ausgabe ist wie folgt:

28.48683906648823 wird ausgegeben, weil dies die Quadratwurzel des Wertes in Lane 1 des Eingabewertes (811.5) ist.

Spezifikationen

Browser-Kompatibilität