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,externoderanysein oder der Name beziehungsweise Index eines im Modul definierten Typs, beispielsweise$my_struct_type.
Operandenstapel
[] -> [output:(ref null heap_type)]
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> |