size: Wasm-Textanweisung

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die size Speicheranweisung wird verwendet, um die aktuelle Anzahl der Seiten in einem Speicher zu erhalten.

Die Anweisung fügt die Größe (in Seiten) oben auf den Stapel hinzu. Derzeit ist jede Seite 64KiB groß.

Probieren Sie es aus

Syntax

Größe des Standardspeichers abrufen

wasm
;; Get the number of pages in the default memory
memory.size
;; The number of pages is now added at top of stack

Größe des angegebenen Speichers abrufen (wenn Multi-Speicher unterstützt wird)

wasm
;; Size of memory with index 1
memory.size (memory 1)

;; Size of memory named $memory2
memory.size (memory $memory2)

Anweisungen und Opcodes

Anweisung Binärer Opcode
memory.size 0x3f

Beispiele

Größe des Standardspeichers abrufen

Der erste Speicher, der einem Wasm-Modul hinzugefügt wird, ist der Standardspeicher und hat den Index 0. Wir können die Anzahl der Seiten in diesem Speicher durch Aufrufen von memory.size erhalten.

Der folgende Code zeigt eine WAT-Datei, die dies demonstriert:

wasm
(module
  (import "console" "log" (func $log (param i32)))
  (memory 1 2) ;; default memory with one page and max of 2 pages

  (func $main
    ;; get size
    memory.size
    call $log ;; log the result (1)

    ;; grow default memory by 1 page
    i32.const 1
    memory.grow

    ;;get size again
    memory.size
    call $log ;; log the result (2)
  )
  (start $main) ;; call immediately on loading
)

Oben mussten wir den Speicherindex in der memory.size-Anweisung nicht angeben, aber wir hätten dies mit dem Speicherindex (0) des Standardspeichers tun können:

wasm
memory.size (memory 0)

Der Vollständigkeit halber können wir die kompilierte Version der obigen Datei size.wasm mit einem ähnlichen Code wie unten gezeigt verwenden (die Log-Funktion wird in das Modul importiert und vom Modul aufgerufen):

js
start();
async function start() {
  const importObject = {
    console: {
      log(arg) {
        console.log(arg);
      },
    },
  };
  const result = await WebAssembly.instantiateStreaming(
    fetch("size.wasm"),
    importObject,
  );
}
start();

Größe eines bestimmten Speichers abrufen

Da Speicher in einem Wasm-Modul definiert sind, wird ihnen sequentiell eine Indexnummer ab null zugewiesen. Sie können die Größe eines bestimmten Speichers abrufen, indem Sie die memory-Anweisung und den gewünschten Index oder Namen (falls vorhanden) nach der memory.size-Anweisung angeben. Wenn Sie keinen bestimmten Speicher angeben, wird der Standardspeicher mit Index 0 verwendet.

Das untenstehende Modul zeigt, wie Sie direkt auf einen Speicher durch Index und Name verweisen könnten.

wasm
(module
  (import "console" "log" (func $log (param i32)))
  (memory 1 2)  ;; Default memory with one page and max of 2 pages
  (memory $memory1 2 4)  ;; Memory with index 1, initial 2 page, max 4 pages
  (func $main
    ;; Get size for memory by index
    memory.size (memory 1)
    call $log ;; log the result (2)

    ;; Get size for memory by memory name
    memory.size (memory $memory1)
    call $log ;; log the result (2)
  )
  (start $main)
)

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
multiMemory

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Hinweis: Speichernutzung in Wasm-Modulen entspricht der WebAssembly.Memory JavaScript API. Der multiMemory Schlüssel zeigt an, in welchen Versionen size mit einem angegebenen Speicher verwendet werden kann.