Struct LazyVec 

pub struct LazyVec<T, S> {
    pub vec: Vec<T>,
    pub terminator: S,
}

A Vec<T> that is filled up to the first appearance of an terminating S. This S may be a subset of T, thus parsing become lazy. This is the same as Cons<Vec<Cons<Except<S>,T>>,S> but more convenient and efficient.

Example

Parse anything until a ;.

let mut token_iter = "foo bar ; baz ;".to_token_iter();

type Example = LazyVec<TokenTree, Semicolon>;

let _example = Example::parse(&mut token_iter).unwrap();
let _example = Example::parse(&mut token_iter).unwrap();

Fields

vec: Vec<T>

The vector of repeating T

terminator: S

The terminating S

Trait Implementations

impl<T, S> Clone for LazyVec<T, S>

where T: Clone, S: Clone,

fn clone(&self) -> LazyVec<T, S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T, S> Debug for LazyVec<T, S>

where T: Debug, S: Debug,

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

Formats the value using the given formatter.

impl<T, S> IntoIterator for LazyVec<T, S>

type Item = T

The type of the elements being iterated over.

type IntoIter = IntoIter<<LazyVec<T, S> as IntoIterator>::Item>

Which kind of iterator are we turning this into?

fn into_iter(self) -> <LazyVec<T, S> as IntoIterator>::IntoIter

Creates an iterator from a value.

impl<T, S> Parser for LazyVec<T, S>

where T: Parse, S: Parse,

fn parser(tokens: &mut TokenIter) -> Result<LazyVec<T, S>, Error>

The actual parsing function that must be implemented. This mutates the tokens iterator directly. It should not be called from user code except for implementing parsers itself and then only when the rules below are followed.

impl<T, S> RangedRepeats for LazyVec<T, S>

where T: Parse, S: Parse,

fn parse_repeats( tokens: &mut TokenIter, min: usize, max: usize, ) -> Result<LazyVec<T, S>, Error>

Parse at least min and up to max (inclusive) elements.

fn parse_any(tokens: &mut TokenIter) -> Result<Self, Error>

Parse any number of elements.

fn parse_many(tokens: &mut TokenIter) -> Result<Self, Error>

Parse at least one element.

fn parse_optional(tokens: &mut TokenIter) -> Result<Self, Error>

Parse zero or one element.

fn parse_exactly(tokens: &mut TokenIter, n: usize) -> Result<Self, Error>

Parse exactly n elements.

fn parse_at_most(tokens: &mut TokenIter, n: usize) -> Result<Self, Error>

Parse at most n elements.

fn parse_at_least(tokens: &mut TokenIter, n: usize) -> Result<Self, Error>

Parse at least n elements.

impl<T, S> ToTokens for LazyVec<T, S>

where T: ToTokens, S: ToTokens,

fn to_tokens(&self, tokens: &mut TokenStream)

Write &self to the given TokenStream.

fn to_token_iter(&self) -> TokenIter

Convert &self into a TokenIter object.

fn into_token_iter(self) -> TokenIter

where Self: Sized,

Convert self into a TokenIter object.

fn to_token_stream(&self) -> TokenStream

Convert &self into a TokenStream object.

fn into_token_stream(self) -> TokenStream

where Self: Sized,

Convert self into a TokenStream object.

fn tokens_to_string(&self) -> String

Convert &self into a String object. This is mostly used in the test suite to compare the outputs. When the input is a &str then this parses it and returns a normalized String.