Enum MemoryError

#[non_exhaustive]
pub enum MemoryError {
    Region(String),
    CouldNotGrow {
        current: Pages,
        attempted_delta: Pages,
    },
    InvalidMemory {
        reason: String,
    },
    MinimumMemoryTooLarge {
        min_requested: Pages,
        max_allowed: Pages,
    },
    MaximumMemoryTooLarge {
        max_requested: Pages,
        max_allowed: Pages,
    },
    MemoryNotShared,
    UnsupportedOperation {
        message: String,
    },
    AtomicsNotSupported,
    Generic(String),
}

Error type describing things that can go wrong when operating on Wasm Memories.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Region(String)

Low level error with mmap.

CouldNotGrow

The operation would cause the size of the memory to exceed the maximum or would cause an overflow leading to unindexable memory.

Fields

current: Pages

The current size in pages.

attempted_delta: Pages

The attempted amount to grow by in pages.

InvalidMemory

Invalid memory was provided.

Fields

reason: String

The reason why the provided memory is invalid.

MinimumMemoryTooLarge

Caller asked for more minimum memory than we can give them.

Fields

min_requested: Pages

The number of pages requested as the minimum amount of memory.

max_allowed: Pages

The maximum amount of memory we can allocate.

MaximumMemoryTooLarge

Caller asked for a maximum memory greater than we can give them.

Fields

max_requested: Pages

The number of pages requested as the maximum amount of memory.

max_allowed: Pages

The number of pages requested as the maximum amount of memory.

MemoryNotShared

Returned when a shared memory is required, but the given memory is not shared.

UnsupportedOperation

Returned when trying to call a memory operation that is not supported by the particular memory implementation.

Fields

message: String

Message describing the unsupported operation.

AtomicsNotSupported

The memory does not support atomic operations.

Generic(String)

A user defined error value, used for error cases not listed above.

Trait Implementations

impl Clone for MemoryError

fn clone(&self) -> MemoryError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MemoryError

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

Formats the value using the given formatter.

impl Display for MemoryError

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

Formats the value using the given formatter.

impl Error for MemoryError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl Hash for MemoryError

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for MemoryError

fn eq(&self, other: &MemoryError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for MemoryError

impl StructuralPartialEq for MemoryError