Struct whasm::grammar::core::list::List

pub struct List<T: Grammar>(pub Vec<T>);

A List<T> is a wrapper for a Vec<T>. It differs from a Vec<T> on how it is deserialized. The serialization of a Vec<T> begins with the number of elements N in the vector followed by each of the N elements. The serialization of a List<T> starts with the first element and continues reading until the iterator is exhausted.

After deserializing the last element of List<T>, the iterator must be exhausted. If not, the List<T> will try to deserialize a new T and append it to the list.

Example

let mut iter = [0x01, 0x02, 0x03, 0x04].iter().copied();
let List(result): List<Byte> = deserialize(&mut iter).unwrap();
assert_eq!(result, vec![0x01, 0x02, 0x03, 0x04]);
assert_eq!(iter.next(), None);

Deserialization will return an error if the iterator is not exhausted.

let mut iter = [0x00, 0x00, 0x00, 0x00, 0x05, 0x06].iter().copied();
let result: Result<List<f32>> = deserialize(&mut iter);
assert!(result.is_err());

Trait Implementations

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

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

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

fn eq(&self, other: &List<T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &List<T>) -> bool

This method tests for !=.

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

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

Formats the value using the given formatter.

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