Struct wasmparser::BinaryReader

source ·

pub struct BinaryReader<'a> { /* private fields */ }

Expand description

A binary reader of the WebAssembly structures and types.

Implementations

source

impl<'a> BinaryReader<'a>

source

pub fn new(data: &[u8]) -> BinaryReader<'_>

Constructs BinaryReader type.

pub fn new_with_offset(data: &[u8], original_offset: usize) -> BinaryReader<'_>

Constructs a BinaryReader with an explicit starting offset.

source

pub fn original_position(&self) -> usize

Gets the original position of the binary reader.

source

pub fn allow_memarg64(&mut self, allow: bool)

Whether or not to allow 64-bit memory arguments in functions.

This is intended to be true when support for the memory64 WebAssembly proposal is also enabled.

source

pub fn range(&self) -> Range<usize>

Returns a range from the starting offset to the end of the buffer.

source

pub fn read_val_type(&mut self) -> Result<ValType>

Reads a core WebAssembly value type from the binary reader.

source

pub fn eof(&self) -> bool

Returns whether the BinaryReader has reached the end of the file.

source

pub fn current_position(&self) -> usize

Returns the BinaryReader’s current position.

source

pub fn bytes_remaining(&self) -> usize

Returns the number of bytes remaining in the BinaryReader.

source

pub fn read_bytes(&mut self, size: usize) -> Result<&'a [u8]>

Advances the BinaryReader size bytes, and returns a slice from the current position of size length.

Errors

If size exceeds the remaining length in BinaryReader.

source

pub fn read_u32(&mut self) -> Result<u32>

Advances the BinaryReader four bytes and returns a u32.

Errors

If BinaryReader has less than four bytes remaining.

source

pub fn read_u64(&mut self) -> Result<u64>

Advances the BinaryReader eight bytes and returns a u64.

Errors

If BinaryReader has less than eight bytes remaining.

source

pub fn read_u8(&mut self) -> Result<u8>

Advances the BinaryReader a single byte.

Errors

If BinaryReader has no bytes remaining.

source

pub fn read_var_u32(&mut self) -> Result<u32>

Advances the BinaryReader up to four bytes to parse a variable length integer as a u32.

Errors

If BinaryReader has less than one or up to four bytes remaining, or the integer is larger than 32 bits.

source

pub fn read_var_u64(&mut self) -> Result<u64>

Advances the BinaryReader up to four bytes to parse a variable length integer as a u64.

Errors

If BinaryReader has less than one or up to eight bytes remaining, or the integer is larger than 64 bits.

source

pub fn skip_bytes(&mut self, len: usize) -> Result<()>

Advances the BinaryReader len bytes, skipping the result.

Errors

If BinaryReader has less than len bytes remaining.

source

pub fn skip_string(&mut self) -> Result<()>

Advances the BinaryReader past a WebAssembly string. This method does not perform any utf-8 validation.

Errors

If BinaryReader has less than four bytes, the string’s length exceeds the remaining bytes, or the string length exceeds limits::MAX_WASM_STRING_SIZE.

source

pub fn read_var_i32(&mut self) -> Result<i32>

Advances the BinaryReader up to four bytes to parse a variable length integer as a i32.

Errors

If BinaryReader has less than one or up to four bytes remaining, or the integer is larger than 32 bits.

source

pub fn read_var_s33(&mut self) -> Result<i64>

Advances the BinaryReader up to four bytes to parse a variable length integer as a signed 33 bit integer, returned as a i64.

Errors

If BinaryReader has less than one or up to five bytes remaining, or the integer is larger than 33 bits.

source

pub fn read_var_i64(&mut self) -> Result<i64>

Advances the BinaryReader up to eight bytes to parse a variable length integer as a 64 bit integer, returned as a i64.

Errors

If BinaryReader has less than one or up to eight bytes remaining, or the integer is larger than 64 bits.

source

pub fn read_f32(&mut self) -> Result<Ieee32>

Advances the BinaryReader up to four bytes to parse a variable length integer as a 32 bit floating point integer, returned as Ieee32.

Errors

If BinaryReader has less than one or up to four bytes remaining, or the integer is larger than 32 bits.

source

pub fn read_f64(&mut self) -> Result<Ieee64>

Advances the BinaryReader up to four bytes to parse a variable length integer as a 32 bit floating point integer, returned as Ieee32.

Errors

If BinaryReader has less than one or up to four bytes remaining, or the integer is larger than 32 bits.

source

pub fn read_string(&mut self) -> Result<&'a str>

Reads a WebAssembly string from the module.

If BinaryReader has less than up to four bytes remaining, the string’s length exceeds the remaining bytes, the string’s length exceeds limits::MAX_WASM_STRING_SIZE, or the string contains invalid utf-8.

source

pub fn visit_operator<T>(
 &mut self,
 visitor: &mut T
) -> Result<<T as VisitOperator<'a>>::Output>where
 T: VisitOperator<'a>,

Visit the next available operator with the specified VisitOperator instance.

Note that this does not implicitly propagate any additional information such as instruction offsets. In order to do so, consider storing such data within the visitor before visiting.

Errors

If BinaryReader has less bytes remaining than required to parse the Operator.

Examples

Store an offset for use in diagnostics or any other purposes:


pub fn dump(mut reader: BinaryReader) -> Result<()> {
    let mut visitor = Dumper { offset: 0 };
    while !reader.eof() {
        visitor.offset = reader.original_position();
        reader.visit_operator(&mut visitor)?;
    }
    Ok(())
}

struct Dumper {
    offset: usize
}

macro_rules! define_visit_operator {
    ($(@$proposal:ident $op:ident $({ $($arg:ident: $argty:ty),* })? => $visit:ident)*) => {
        $(
            fn $visit(&mut self $($(,$arg: $argty)*)?) -> Self::Output {
                println!("{}: {}", self.offset, stringify!($visit));
            }
        )*
    }
}

impl<'a> VisitOperator<'a> for Dumper {
    type Output = ();
    for_each_operator!(define_visit_operator);
}