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

View in English Always switch to English

null: Wasm-Referenzanweisung

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit November 2021 browserübergreifend verfügbar.

Die ref.null-Referenzanweisung erzeugt eine Nullreferenz eines angegebenen Heap-Typs.

Probieren Sie es aus

(module
  (import "console" "log" (func $log (param externref)))
  (func $main
    ref.null extern
    call $log ;; log a null externref
  )
  (start $main)
)
const url = "{%wasm-url%}";
await WebAssembly.instantiateStreaming(fetch(url), { console });

WAT-Syntax

ref.null heap_type
ref.null

Die ref.null-Anweisung.

Unmittelbare Operanden

heap_type

Der Heap-Typ der zu erzeugenden Nullreferenz. Dies kann ein abstrakter Heap-Typ wie func, extern oder any sein oder der Name beziehungsweise Index eines im Modul definierten Typs, beispielsweise $my_struct_type.

Operandenstapel

[] -> [output:(ref null heap_type)]
output

Eine Nullreferenz vom Typ (ref null heap_type). Beispielsweise erzeugt ref.null func eine Nullreferenz vom Typ funcref und ref.null extern eine Nullreferenz vom Typ externref.

Binärkodierung

Anweisung Binärformat Beispiel: Text => Binärformat
ref.null 0xd0 ht:heap_type ref.null extern => 0xd0 0x6f

Beschreibung

Die ref.null-Anweisung erzeugt eine Referenz, die auf nichts verweist. Nullreferenzen werden häufig verwendet, um lokale Variablen, globale Variablen und Tabellenelemente mit nullable Referenztypen zu initialisieren, bevor eine tatsächliche Referenz verfügbar ist, oder um beim Aufruf von Funktionen, die eine nullable Referenz erwarten, „kein Wert“ darzustellen.

Da ref.null eine konstante Anweisung ist, kann sie in konstanten Ausdrücken verwendet werden, beispielsweise als Initialisierungswert einer global oder als Eintrag in einem elem-Segment.

Wenn eine Nullreferenz an JavaScript übergeben wird, wird sie in null umgewandelt.

Um zu prüfen, ob eine Referenz null ist, verwenden Sie ref.is_null.

Spezifikationen

Spezifikation
WebAssembly Core Specification
# -hrefsyntax-instr-refmathsfrefnullmathitht

Browser-Kompatibilität

Siehe auch