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 ShadowCountedIter<'_, <TokenStream as IntoIterator>::IntoIter>, ) -> 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 ShadowCountedIter<'_, <TokenStream as IntoIterator>::IntoIter>, min: usize, max: usize, ) -> Result<LazyVec<T, S>, Error>

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

fn parse_any( tokens: &mut ShadowCountedIter<'_, <TokenStream as IntoIterator>::IntoIter>, ) -> Result<Self, Error>

Parse any number of elements.

fn parse_many( tokens: &mut ShadowCountedIter<'_, <TokenStream as IntoIterator>::IntoIter>, ) -> Result<Self, Error>

Parse at least one element.

fn parse_optional( tokens: &mut ShadowCountedIter<'_, <TokenStream as IntoIterator>::IntoIter>, ) -> Result<Self, Error>

Parse zero or one element.

fn parse_exactly( tokens: &mut ShadowCountedIter<'_, <TokenStream as IntoIterator>::IntoIter>, n: usize, ) -> Result<Self, Error>

Parse exactly n elements.

fn parse_at_most( tokens: &mut ShadowCountedIter<'_, <TokenStream as IntoIterator>::IntoIter>, n: usize, ) -> Result<Self, Error>

Parse at most n elements.

fn parse_at_least( tokens: &mut ShadowCountedIter<'_, <TokenStream as IntoIterator>::IntoIter>, 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, ) -> ShadowCountedIter<'_, <TokenStream as IntoIterator>::IntoIter>

Convert &self into a TokenIter object.

fn into_token_iter<'a>( self, ) -> ShadowCountedIter<'a, <TokenStream as IntoIterator>::IntoIter>

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.