Struct wasm_encoder::SymbolTable

pub struct SymbolTable { /* private fields */ }

A subsection of the linking custom section that provides extra information about the symbols present in this Wasm object file.

Implementations

impl SymbolTable

pub fn new() -> Self

Construct a new symbol table subsection encoder.

pub fn function(&mut self, flags: u32, index: u32, name: Option<&str>) -> &mut Self

Define a function symbol in this symbol table.

The name must be omitted if index references an imported table and the WASM_SYM_EXPLICIT_NAME flag is not set.

pub fn global(&mut self, flags: u32, index: u32, name: Option<&str>) -> &mut Self

Define a global symbol in this symbol table.

The name must be omitted if index references an imported table and the WASM_SYM_EXPLICIT_NAME flag is not set.

pub fn table(&mut self, flags: u32, index: u32, name: Option<&str>) -> &mut Self

Define a table symbol in this symbol table.

The name must be omitted if index references an imported table and the WASM_SYM_EXPLICIT_NAME flag is not set.

pub fn data(
    &mut self,
    flags: u32,
    name: &str,
    definition: Option<DataSymbolDefinition>
) -> &mut Self

Add a data symbol to this symbol table.

pub const WASM_SYM_BINDING_WEAK: u32 = 1u32

This is a weak symbol.

This flag is mutually exclusive with WASM_SYM_BINDING_LOCAL.

When linking multiple modules defining the same symbol, all weak definitions are discarded if any strong definitions exist; then if multiple weak definitions exist all but one (unspecified) are discarded; and finally it is an error if more than one definition remains.

pub const WASM_SYM_BINDING_LOCAL: u32 = 2u32

This is a local symbol.

This flag is mutually exclusive with WASM_SYM_BINDING_WEAK.

Local symbols are not to be exported, or linked to other modules/sections. The names of all non-local symbols must be unique, but the names of local symbols are not considered for uniqueness. A local function or global symbol cannot reference an import.

pub const WASM_SYM_VISIBILITY_HIDDEN: u32 = 4u32

This is a hidden symbol.

Hidden symbols are not to be exported when performing the final link, but may be linked to other modules.

pub const WASM_SYM_UNDEFINED: u32 = 16u32

This symbol is not defined.

For non-data symbols, this must match whether the symbol is an import or is defined; for data symbols, determines whether a segment is specified.

pub const WASM_SYM_EXPORTED: u32 = 32u32

This symbol is intended to be exported from the wasm module to the host environment.

This differs from the visibility flags in that it effects the static linker.

pub const WASM_SYM_EXPLICIT_NAME: u32 = 64u32

This symbol uses an explicit symbol name, rather than reusing the name from a wasm import.

This allows it to remap imports from foreign WebAssembly modules into local symbols with different names.

pub const WASM_SYM_NO_STRIP: u32 = 128u32

This symbol is intended to be included in the linker output, regardless of whether it is used by the program.

Trait Implementations

impl Clone for SymbolTable

fn clone(&self) -> SymbolTable

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SymbolTable

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SymbolTable

fn default() -> SymbolTable

Returns the “default value” for a type.

impl Encode for SymbolTable

fn encode(&self, sink: &mut Vec<u8>)

Encode the type into the given byte sink.