load: Wasm-Textanweisung
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die load
Speicheranweisungen werden verwendet, um eine Zahl aus einem Speicher auf den Stapel zu laden.
Es gibt load
-Anweisungen für das Laden aus einem Speicher in ein i32
, i64
, f32
und f64
. Für die Ganzzahlen gibt es separate Anweisungsvarianten zum Laden einer engeren signierten und unsignierten Zahl aus dem Speicher und zum Erweitern in einen breiteren Typ. Zum Beispiel können Sie eine unsignierte 8-Bit-Zahl laden und in ein i32
mit i32.load8_u
umwandeln. Alle Varianten sind unten aufgelistet.
Probieren Sie es aus
Syntax
Laden aus dem Standard-Speicher
;; Load from default memory at offset specified by value on top of stack
i32.const 0 ;; Stack variable containing memory offset (0) of number to be loaded.
i32.load ;; Load from specified offset in default memory
;; Load from same location using an S-function
(i32.load (i32.const 0))
Laden aus einem angegebenen Speicher (falls Multi-Speicher unterstützt wird)
;; Load from memory specified by index
i32.const 0 ;; offset in memory to load from (0)
i32.load (memory 1) ;; load from memory index 1
;; Load from memory specified by name
i32.const 1 ;; offset in memory to load from (1)
i32.load (memory $memory1) ;; load from named memory $memory1
;; Load from memory specified by name using an S-function
(i32.load (memory $memory1) (i32.const 0))
Anweisungen und Opcodes
Anweisung | Binärer Opcode |
---|---|
i32.load |
0x28 |
i64.load |
0x29 |
f32.load |
0x2a |
f64.load |
0x2b |
i32.load8_s |
0x2c |
i32.load8_u |
0x2d |
i32.load16_s |
0x2e |
i32.load16_u |
0x2f |
i64.load8_s |
0x30 |
i64.load8_u |
0x31 |
i64.load16_s |
0x32 |
i64.load16_u |
0x33 |
i64.load32_s |
0x34 |
i64.load32_u |
0x35 |
Beispiele
Laden von Elementen aus dem Standard-Speicher
Der erste Speicher, der einem Wasm-Modul hinzugefügt wird, ist der Standardspeicher und hat den Index 0. Wir können aus diesem Speicher laden, indem wir eine Variable hinzufügen, die den Offset im Standardspeicher der Zahl angibt, die auf den Stapel geladen werden soll, und dann load
aufrufen.
Der unten gezeigte Code zeigt eine WAT-Datei, die dies demonstriert:
(module
;; Define memory named $memory and export
(memory $memory 1) ;; First memory declared is default, with index 0
(export "memory" (memory $memory))
;; Exported function to load first item in default memory
(func (export "load_first_item_in_mem") (param $num i32) (result i32)
;; load 0-offset item in memory and return the result
i32.const 0
i32.load
)
)
Oben mussten wir den Speicher in der Ladeanweisung nicht spezifizieren, aber wir hätten dies sowohl mit dem Namen als auch mit dem Index des Standardspeichers tun können. Das wird im folgenden Beispiel gezeigt.
Vollständig können wir die kompilierte Version der obigen Datei load_single.wasm
mit einem Code verwenden, der dem unten gezeigten ähnelt:
// await on the specified .wasm file to be fetched and loaded
const result = await WebAssembly.instantiateStreaming(
fetch("load_single.wasm"),
);
// Get the exported function that we will call below
const load_first_item_in_mem = result.instance.exports.load_first_item_in_mem;
// Get the exported memory and store 30 at the 0 offset
const memory = result.instance.exports.memory;
const dataView = new DataView(memory.buffer);
dataView.setUint32(0, 30, true);
// Log the result of calling the exported Wasm function
console.log(load_first_item_in_mem(100)); // 30
Laden von Elementen aus einem angegebenen Speicher
Wenn Speicher in einem Wasm-Modul definiert werden, wird ihnen der Reihe nach eine Indexnummer ab null zugewiesen. Sie können aus einem bestimmten Speicher laden, indem Sie die memory
-Anweisung und den gewünschten Index oder Namen nach der load
-Anweisung angeben. Wenn Sie keinen bestimmten Speicher angeben, wird der Standardspeicher mit dem Index 0 verwendet.
Das untenstehende Modul zeigt, wie man einen Speicher direkt über den Index referenzieren könnte.
(module
;; Define memory for the module
(memory $memory0 1) ;; First (default) memory with memory index 0 (and 1 page)
(memory $memory1 1) ;; Second memory with index 1, named $memory1
(export "memory" (memory $memory1)) ;; Export $memory1
;; Exported function to load first item in default memory
(func (export "load_first_item_in_mem") (param $num i32) (result i32)
;; load 0-offset item in memory index 1 and return the result
i32.const 0
i32.load (memory 1)
)
)
Der Körper der Funktion hätte auch mit einer der folgenden Optionen geschrieben werden können:
i32.const 0
i32.load (memory $memory1) ;; referencing memory by name
;; Using S-functions
(i32.load (memory 1) (i32.const 0)) ;; reference memory by index
(i32.load (memory $memory1) (i32.const 0)) ;; reference memory by name
Wir haben im Beispiel nicht den Standardspeicher verwendet. Sie können aber auch wählen, diesen Index zu spezifizieren, falls Sie das möchten:
i32.const 0
i32.load (memory 0) ;; referencing memory by index
;; Using S-functions
(i32.load (i32.const 0))
(i32.load (memory 0) (i32.const 0)) ;; reference memory by index
(i32.load (memory $memory0) (i32.const 0)) ;; reference memory by name
Die WAT-Dateien könnten mit demselben JavaScript-Code wie im ersten Beispiel geladen werden.
Spezifikationen
Specification |
---|
Unknown specification # syntax-instr-memory |
Browser-Kompatibilität
BCD tables only load in the browser
Hinweis: Speicherunterstützung in Wasm-Modulen entspricht der WebAssembly.Memory
JavaScript-API.
Der multiMemory Schlüssel gibt die Versionen an, in denen load
mit einem angegebenen Speicher verwendet werden kann.