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

View in English Always switch to English

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

wat
;; 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-Werte
  • i16x8 : 8 16-Bit-Integer-Werte
  • i32x4 : 4 32-Bit-Integer-Werte
  • i64x2 : 2 64-Bit-Integer-Werte
  • f32x4 : 4 32-Bit-Gleitkommawerte
  • f64x2 : 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.

wat
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:

wat
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:

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

Browser-Kompatibilität

Siehe auch