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

View in English Always switch to English

eq: Wasm-Referenzanweisung

Baseline 2024
Neu verfügbar

Seit Dezember 2024 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

Die Referenzanweisung ref.eq prüft, ob zwei Referenzen gleich sind.

Probieren Sie es aus

(module
  (import "console" "log" (func $log (param i32)))
  (type $point (struct (field i32) (field i32)))

  (func $main
    (local $a (ref $point))
    (local $b (ref $point))
    (local.set $a (struct.new $point (i32.const 1) (i32.const 2)))
    (local.set $b (struct.new $point (i32.const 1) (i32.const 2)))

    (call $log (ref.eq (local.get $a) (local.get $a))) ;; log 1: same struct instance
    (call $log (ref.eq (local.get $a) (local.get $b))) ;; log 0: different struct instances
  )
  (start $main)
)
const url = "{%wasm-url%}";
await WebAssembly.instantiateStreaming(fetch(url), { console });

WAT-Syntax

ref.eq
ref.eq

Die Anweisung ref.eq.

Unmittelbare Operanden

Keine.

Operandenstapel

[input1:eqref input2:eqref] -> [output:i32]
input1

Die erste zu vergleichende Referenz. Sie muss ein eqref ((ref null eq)) oder ein Untertyp davon sein, beispielsweise eine Referenz auf einen Struct- oder Array-Typ oder ein i31ref.

input2

Die zweite zu vergleichende Referenz. Für sie gelten dieselben Typanforderungen wie für input1.

output

Ein i32, das 1 ist, wenn beide Referenzen gleich sind, andernfalls 0.

Binäre Kodierung

Anweisung Binärformat Beispiel: Text => Binärdarstellung
ref.eq 0xd3 ref.eq => 0xd3

Beschreibung

Struct- und Array-Referenzen werden anhand ihrer Identität verglichen, nicht anhand ihrer Feldwerte. Im obigen Beispiel sind $a und $b getrennte Struct-Instanzen mit denselben Feldwerten. Ein Vergleich der beiden ergibt daher 0, während ein Vergleich von $a mit sich selbst 1 ergibt.

Zwei Nullreferenzen sind gleich. Zwei i31ref-Werte sind gleich, wenn sie dieselbe Ganzzahl enthalten.

ref.eq kann nur Referenzen vergleichen, die Untertypen von eqref sind. eqref umfasst Referenzen, die auf Gleichheit verglichen werden können: i31ref, structref, arrayref, Referenzen auf im Modul definierte Struct- und Array-Typen sowie Nullreferenzen dieser Typen. Mit ref.eq können Sie keine funcref- oder externref-Werte vergleichen. Ein Modul, das dies versucht, besteht die Validierung nicht.

Spezifikationen

Spezifikation
WebAssembly Core Specification
# -hrefsyntax-instr-refmathsfrefeq

Browser-Kompatibilität

Siehe auch