shl: Wasm-Textanweisung

Die shl-Anweisung, kurz für shift-left, wird für die Durchführung einer bitweisen Linksverschiebung verwendet, ähnlich dem <<-Operator in anderen Sprachen.

Probieren Sie es aus

(module
 (func (export "shift_left") (param $num i32) (param $by i32) (result i32)
 ;; load the number to shift and the by how many spots
 local.get $num
 local.get $by
 ;; shift and return the result
 i32.shl
 )
)

const url = "{%wasm-url%}";
await WebAssembly.instantiateStreaming(fetch(url), { console }).then(
 (result) => {
 const shift_left = result.instance.exports.shift_left;
 const res = shift_left(0b11100000_00000000_00000000_00000000, 1);
 console.log(numToBin(res));
 // Expected output: "11000000_00000000_00000000_00000000"
 },
);
function numToBin(num) {
 return (num >>> 0)
 .toString(2)
 .padStart(32, "0")
 .match(/.{1,8}/g)
 .join("_");
}

Syntax

value_type.shl

value_type

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

• i32
• i64
• v128-Interpretationen:
  • i8x16
  • i16x8
  • i32x4
  • i64x2

shl

Die shl-Anweisung. Muss immer nach dem value_type und einem Punkt (.) stehen.

Typ

[input, shift_value] -> [output]

input

Der Eingabewert.

shift_value

Der Wert, um den Sie den Wert verschieben möchten.

output

Der Ausgabewert.

Für ein nicht-SIMD shl sind input und output einfache numerische Werte wie 3 oder 10.

Für ein SIMD shl sind input und output v128-Wertinterpretationen, zum Beispiel i32x4 4 8 12 16. Jede Lane des in den Stapel gepushten Ausgabes enthält die entsprechende Lane im Eingabewert, die um den angegebenen shift_value nach links verschoben wurde.

Binärkodierung

Beispiele

Grundlegende Verwendung

;; load two numbers onto the stack
i32.const 7 ;; 00000111
i32.const 1 ;; left shift one spot
;; perform a bitwise left-shift
i32.shl
;; the top item on the stack will now be 14 (00001110)

SIMD-Linksverschiebung

In diesem Beispiel demonstrieren wir die Durchführung einer Linksverschiebung auf einem SIMD-Wert und geben einen der Lane-Werte aus.

JavaScript

In unserem Skript holen wir eine Referenz zu einem <p>-Element, in das wir unser Ergebnis ausgeben werden. Dann definieren wir ein Objekt für den Import in Wasm, das eine einzelne Funktion enthält, die einen Wert an das Ausgabeelement <p> schreibt. Danach kompilieren und instanziieren wir unser Wasm-Modul mit der Methode WebAssembly.instantiateStreaming(), wobei wir das Objekt während des Prozesses 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() und deklarieren dabei, dass sie einen i32-Parameter hat. Dann deklarieren wir einen SIMD i32x4-Wert und verschieben ihn nach links um 2 mit i32x4.shl. Schließlich extrahieren wir den Wert, der in Lane 3 des Ausgabes-SIMD-Wertes gespeichert ist, mit der Anweisung extract_lane und geben ihn an das DOM aus, indem wir die importierte output()-Funktion aufrufen.

(module
 ;; Import output function
 (import "obj" "output" (func $output (param i32)))
 (func $main
 ;; load two SIMD values onto the stack
 v128.const i32x4 9 10 11 12
 i32.const 2
 i32x4.shl ;; shift-left by 2
 i32x4.extract_lane 3 ;; Extract a value from the result
 call $output
 )
 (start $main)
)

Ergebnis

Die Ausgabe ist wie folgt:

Das Ergebnis ist 48, weil der in Lane 3 des Eingabewertes gespeicherte Wert 12 ist. Einmal um zwei Positionen nach links verschoben, enthält Lane 3 des Ausgabewertes den Wert 48.

Siehe auch

• shr_s
• shr_u