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

View in English Always switch to English

neg: Wasm-Text-Anweisung

Die neg-Anweisung, kurz für negieren, wird verwendet, um eine Zahl zu negieren. Das heißt, sie verwandelt eine positive Zahl in eine negative Zahl und eine negative Zahl in eine positive Zahl.

Probieren Sie es aus

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

    f32.const 10 ;; load a number onto the stack
    f32.neg ;; negate the values
    call $log ;; log the result

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

Syntax

value_type.neg
value_type

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

  • f32
  • f64
  • v128-Interpretationen:
    • i8x16
    • i16x8
    • i32x4
    • i64x2
    • f32x4
    • f64x2
neg

Die neg-Anweisung. Muss immer nach dem value_type und einem Punkt (.) angegeben werden.

Typ

[input] -> [output]
input2

Der Eingabewert.

output

Der Ausgabewert.

Für einen nicht-SIMD neg sind die Werte einfache numerische Werte wie 3 oder -3.5.

Für eine SIMD neg sind die Werte v128-Werteinterpretationen, zum Beispiel f32x4 8 -27.3 30 -0.5. Jede Lane des Outputs, die auf den Stack geschoben wird, entspricht der negierten jeweiligen Lane des Eingabewertes.

Binäre Codierung

Anweisung Binärformat Beispiel Text => binär
f32.neg 0x8c f32.neg => 0x8c
f64.neg 0x9a f64.neg => 0x9a
i8x16.neg 0xfd 97:u32 i8x16.neg => 0xfd 0x61
i16x8.neg 0xfd 129:u32 i16x8.neg => 0xfd 0x81 0x01
i32x4.neg 0xfd 161:u32 i32x4.neg => 0xfd 0xa1 0x01
i64x2.neg 0xfd 193:u32 i64x2.neg => 0xfd 0xc1 0x01
f32x4.neg 0xfd 225:u32 f32x4.neg => 0xfd 0xe1 0x01
f64x2.neg 0xfd 237:u32 f64x2.neg => 0xfd 0xed 0x01

Beispiele

SIMD-Negation

In diesem Beispiel demonstrieren wir die Verwendung von neg, um einen SIMD-Wert zu negieren.

JavaScript

In unserem Skript greifen wir auf ein <p>-Element zu, in das wir unser Ergebnis ausgeben werden. Dann definieren wir ein Objekt zum Importieren in Wasm, das eine einzige Funktion enthält, die einen Wert in das Ausgabeelement <p> schreibt. Danach kompilieren und instanziieren wir 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 zunächst die JavaScript-Funktion output() und stellen sicher, dass sie einen i32-Parameter hat. Dann deklarieren wir einen SIMD-i8x16-Wert und verwenden i8x16.neg, um alle Lanes des Wertes zu negieren. Schließlich extrahieren wir den Wert, der in Lane 15 des Ausgabe-Werts gespeichert ist, mit der Anweisung extract_lane_s und geben ihn aus, indem wir die importierte Funktion output() aufrufen.

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

  (func $main
    ;; load a SIMD value onto the stack
    v128.const i8x16 -1 0 3 8 15 -2 -32 -11 -2 1 5 8 -3 -5 0 -6

    i8x16.neg ;; Negate all the lanes
    i8x16.extract_lane_s 15 ;; Extract a value from the result
    call $output
  )

  (start $main)
)

Ergebnis

Die Ausgabe ist wie folgt:

6 wird ausgegeben, weil es die Negation des Wertes in Lane 15 des Eingabewertes ist.