v128: Wasm-Werttyp
Der v128-Werttyp ist ein Vektortyp, der 128-Bit an gepackten Integer- oder Gleitkomma-Daten darstellt. Ein v128-Wert kann von SIMD-Instruktionen auf verschiedene Arten interpretiert werden.
Probieren Sie es aus
(module
(import "console" "log" (func $log (param f32)))
(func $main
;; load two SIMD values onto the stack
(v128.const f32x4 0x9 0xa 0xb 0xc)
(v128.const f32x4 0x10 0x11 0x12 0x13)
f32x4.add ;; add the two values
f32x4.extract_lane 0 ;; Extract a float value from the result
call $log ;; log the result
)
(start $main)
)
WebAssembly.instantiateStreaming(fetch("{%wasm-url%}"), { console });
Syntax
;; Example of a v128-specific instruction
(v128.load32_splat align=2 (i32.const 0))
;; Example of general numeric instruction
(v128.const f32x4 0x10 0x11 0x12 0x13)
;; Example of an instruction working on
;; a specific v128 interpretation
i32x4.add
Beschreibung
Der v128-Typ wird verwendet, um SIMD (Single Instruction, Multiple Data) Werte in Wasm-Modulen zu definieren und zu manipulieren, was eine effizientere Datenverarbeitung ermöglicht, indem einzelne Instruktionen gleichzeitig auf mehrere Datenpunkte angewendet werden.
Ein v128-Wert repräsentiert 128-Bit an gepackten Integer- oder Gleitkomma-Daten, die von SIMD-Instruktionen auf verschiedene Weisen interpretiert werden können. Abhängig von der gewählten Wertstruktur werden die 128-Bit Daten in mehrere Lanes aufgeteilt, von denen jede einen separaten Wert enthält.
Sie können einen v128-Wert wie folgt interpretieren:
i8x16: 16 8-Bit-Integer-Wertei16x8: 8 16-Bit-Integer-Wertei32x4: 4 32-Bit-Integer-Wertei64x2: 2 64-Bit-Integer-Wertef32x4: 4 32-Bit-Gleitkommawertef64x2: 2 64-Bit-Gleitkommawerte
Zum Beispiel verwendet das folgende Beispiel die const-Instruktion, um einen f32x4-Wert zu erstellen, der 4 32-Bit-Gleitkommawerte enthält — 65.4, 780.9, 1011.1 und 3.0.
v128.const f32x4 65.4 780.9 1011.1 3.0
Wir könnten dann alle vier Werte gleichzeitig mit der floor-Instruktion auf die nächstgelegene ganze Zahl abrunden:
f32x4.floor
Die vorherige Instruktion würde einen f32x4 Wert von 65 780 1011 3 ausgeben.
Beachten Sie, dass SIMD-Lanes nullindexiert sind. Im vorherigen Ausgabe-Wert:
- Lane 0 enthält
65. - Lane 1 enthält
780. - Lane 2 enthält
1011. - Lane 3 enthält
3.
Einige Instruktionen arbeiten direkt auf dem v128-Typ:
- v128-spezifische Instruktionen wie
load-Instruktionen. - Allgemeine numerische Instruktionen wie
const-Instruktion.
Die meisten SIMD-Instruktionen arbeiten jedoch auf Interpretationen des v128-Typs. Auf der SIMD-Instruktionen-Seite finden Sie die vollständige Liste.
Hinweis: Wasm-SIMD-Werte können nur innerhalb von Wasm-Modulen verwendet werden. Der Versuch, sie außerhalb (zum Beispiel durch Übergeben an importierte JavaScript-Funktionen als Parameter) zu verwenden, resultiert in einem Fehler.
Spezifikationen
| Spezifikation |
|---|
| WebAssembly Core Specification> # vector-types%E2%91%A0> |