Struct SectionLimited

pub struct SectionLimited<'a, T> { /* private fields */ }

A generic structure for reading a section of a WebAssembly binary which has a limited number of items within it.

Many WebAssembly sections are a count of items followed by that many items. This helper structure can be used to parse these sections and provides an iteration-based API for reading the contents.

Note that this always implements the Clone trait to represent the ability to parse the section multiple times.

Implementations

impl<'a> SectionLimited<'a, RecGroup>

pub fn into_iter_err_on_gc_types( self, ) -> impl Iterator<Item = Result<FuncType, BinaryReaderError>> + 'a

Returns an iterator over this type section which will only yield function types and any usage of GC types from the GC proposal will be translated into an error.

impl<'a, T> SectionLimited<'a, T>

pub fn new( reader: BinaryReader<'a>, ) -> Result<SectionLimited<'a, T>, BinaryReaderError>

Creates a new section reader from the provided contents.

The data provided here is the data of the section itself that will be parsed. The offset argument is the byte offset, in the original wasm binary, that the section was found. The offset argument is used for error reporting.

Errors

Returns an error if a 32-bit count couldn’t be read from the data.

pub fn count(&self) -> u32

Returns the count of total items within this section.

pub fn original_position(&self) -> usize

Returns whether the original byte offset of this section.

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

Returns the range, as byte offsets, of this section within the original wasm binary.

pub fn into_iter_with_offsets(self) -> SectionLimitedIntoIterWithOffsets<'a, T>

where T: FromReader<'a>,

Returns an iterator which yields not only each item in this section but additionally the offset of each item within the section.

Trait Implementations

impl<T> Clone for SectionLimited<'_, T>

fn clone(&self) -> SectionLimited<'_, T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for SectionLimited<'_, T>

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

Formats the value using the given formatter.

impl<'a, T> IntoIterator for SectionLimited<'a, T>

where T: FromReader<'a>,

type Item = Result<T, BinaryReaderError>

The type of the elements being iterated over.

type IntoIter = SectionLimitedIntoIter<'a, T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> <SectionLimited<'a, T> as IntoIterator>::IntoIter

Creates an iterator from a value.