Trait whasm::grammar::core::Grammar

pub trait Grammar where
    Self: Sized, {
    fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>;
}

Trait that describes an element of the WebAssembly grammar (as defined in the WebAssembly Specification). Objects that implement this trait can be deserialized from an Iterator<u8>.

This trait requires implementing the deserialize method. However, in most cases the Grammar derive macro can be used instead. The derive macro defines new grammars declaratively, making it the preferred approach to define new grammars.

Example

struct AsciiChar(char);
impl Grammar for AsciiChar {
    fn deserialize<Iter: Iterator<Item=u8>>(iter: &mut Iter) -> Result<Self> {
        let Byte(byte) = deserialize(iter)?;
        if byte & 0x80 != 0 {
            Err("The most significant bit of an ASCII character must be 0.")?;
        }
        Ok(AsciiChar(byte as char))
    }
}

Required methods

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

Loading content...

Implementations on Foreign Types

impl Grammar for u8

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for u16

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for u32

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for u64

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for usize

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for i8

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for i16

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for i32

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for i64

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for isize

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl<T: Grammar> Grammar for Vec<T>

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for String

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for f32

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for f64

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl<T: Grammar> Grammar for [T; 0]

fn deserialize<Iter: Iterator<Item = u8>>(_iter: &mut Iter) -> Result<Self>

impl<T: Grammar> Grammar for [T; 1]

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl<T: Grammar> Grammar for [T; 2]

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl<T: Grammar> Grammar for [T; 3]

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl<T: Grammar> Grammar for [T; 4]

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl<T: Grammar> Grammar for [T; 5]

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl<T: Grammar> Grammar for [T; 6]

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl<T: Grammar> Grammar for [T; 7]

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl<T: Grammar> Grammar for [T; 8]

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

Loading content...

Implementors

impl Grammar for Instruction

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for ExportDesc

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for ImportDesc

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for Section

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for BlockType

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for ElemType

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for FuncType

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for Limits

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for Mut

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for ValType

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for Byte

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

Read a Byte from an Iterator<u8>. It returns Ok(Byte(_)) on success, and Error(Error::UnexpectedEndOfStream) if the iterator returns None.

Deserializing a Byte instead of using iter.next() is an easy way to convert the Option<u8> returned by the iterator into a Result<u8> with a meaningful error type.

impl Grammar for FuncIdx

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for GlobalIdx

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for LabelIdx

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for LocalIdx

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for MemIdx

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for TableIdx

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for TypeIdx

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for BlockInstr

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for Expression

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for IfInstr

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for MemArg

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for Module

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for CodeSection

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for CustomSection

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for Data

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for DataSection

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for Element

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for ElementSection

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for Export

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for ExportSection

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for FuncSection

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for Function

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for Global

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for GlobalSection

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for Import

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for ImportSection

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for Locals

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for Memory

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for MemorySection

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for StartSection

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for Table

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for TableSection

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for TypeSection

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for GlobalType

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for MemType

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl Grammar for TableType

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

impl<T: Grammar> Grammar for List<T>

fn deserialize<Iter: Iterator<Item = u8>>(iter: &mut Iter) -> Result<Self>

Loading content...