Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

le: Wasm-Textinstruktion

Die le-Instruktion, kurz für less or equal (kleiner oder gleich), überprüft, ob eine Fließkommazahl kleiner oder gleich einer anderen Fließkommazahl ist.

Ganzzahltypen haben separate Instruktionen für kleiner oder gleich für vorzeichenbehaftete (le_s) und vorzeichenlose (le_u) Vergleiche.

Probieren Sie es aus

(module
  (import "env" "log_bool" (func $log_bool (param i32)))
  (func $main
    ;; load 10.5 and 3.5 onto the stack
    f32.const 10.5
    f32.const 3.5

    f32.le ;; check if 10.5 is less than or equal to 3.5
    call $log_bool ;; log the result
  )
  (start $main)
)
const url = "{%wasm-url%}";

function log_bool(value) {
  console.log(Boolean(value));
  // Expected output: false
}

await WebAssembly.instantiateStreaming(fetch(url), {
  env: { log_bool },
});

Syntax

value_type.le
value_type

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

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

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

Typ

[input1, input2] -> [output]
input1

Der erste Eingabewert.

input2

Der zweite Eingabewert.

output

Der Ausgabewert, der ein Ganzzahltyp sein wird.

Für ein nicht-SIMD le sind die Eingaben einfache numerische Werte wie 3.0 oder 3.5. Wenn der erste Eingabewert kleiner oder gleich dem zweiten Eingabewert ist, wird 1 auf den Stapel als Ausgabe geschoben, andernfalls 0.

Für ein SIMD le sind die Eingaben v128 Wertinterpretationen, zum Beispiel f32x4 2.0 30 86.9 120. Jede Ausgabelane, die auf den Stapel geschoben wird, ist eine 1 oder 0, was anzeigt, ob die entsprechende Lane des ersten Eingabewertes kleiner oder gleich der entsprechenden Lane des zweiten Eingabewertes ist.

Binärcodierung

Instruktion Binärformat Beispieltext => binär
f32.le 0x5f f32.le => 0x5f
f64.le 0x65 f64.le => 0x65
f32x4.le 0xfd 69:u32 f32x4.le => 0xfd 0x45
f64x2.le 0xfd 75:u32 f64x2.le => 0xfd 0x4b

Beispiele

SIMD le Beispiel

In diesem Beispiel demonstrieren wir die Verwendung von le, um zu testen, ob ein SIMD-Lane-Wert kleiner oder gleich dem gleichen Lane-Wert in einem anderen SIMD-Wert ist.

JavaScript

In unserem Skript holen wir uns eine Referenz zu einem <p>-Element, an das wir unser Ergebnis ausgeben werden. Dann definieren wir ein Objekt für den Import in Wasm, das eine einzige Funktion enthält, die einen Wert an das Ausgabeelement <p> schreibt. Wir kompilieren und instanziieren unser Wasm-Modul mit der Methode WebAssembly.instantiateStreaming() und importieren dabei das Objekt.

js
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 darauf achten, dass diese eine i32-Parameter hat. Wir deklarieren dann zwei SIMD-f32x4-Werte und überprüfen, ob die Lanes des ersten Wertes kleiner oder gleich denen des zweiten Wertes mit f32x4.le sind. Schließlich extrahieren wir den Wert, der in Lane 3 des Ausgabewertes gespeichert ist, mit der extract_lane-Instruktion und geben diesen an das DOM aus, indem wir die importierte output()-Funktion aufrufen.

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

  (func $main
    ;; load two SIMD values onto the stack
    v128.const f32x4 20 12 15 102
    v128.const f32x4 20 12 15 100

    ;; check whether the first value is less than or equal to the second
    f32x4.le
    i32x4.extract_lane 3 ;; Extract a value from the result

    call $output
  )

  (start $main)
)

Ergebnis

Die Ausgabe ist wie folgt:

Das Ergebnis ist 0, weil der in Lane 3 des ersten Eingabewertes gespeicherte Wert nicht kleiner oder gleich dem in Lane 3 des zweiten Eingabewertes gespeicherten Wert ist.

Siehe auch