Struct LazyVecUntil 

pub struct LazyVecUntil<T, S> {
    pub vec: Vec<T>,
    /* private fields */
}

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. Unlike LazyVec this variant does not consume the final terminator. This is the same as Vec<Cons<Except<S>,T>>> but more convenient.

Example

Parse anything until a ;.

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

type Example = LazyVecUntil<TokenTree, Semicolon>;

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

Fields

vec: Vec<T>

The vector of repeating T

Trait Implementations

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

where T: Clone, S: Clone,

fn clone(&self) -> LazyVecUntil<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 LazyVecUntil<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 LazyVecUntil<T, S>

type Item = T

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

where T: Parse, S: Parse,

fn parser(tokens: &mut TokenIter) -> Result<LazyVecUntil<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 LazyVecUntil<T, S>

where T: Parse, S: Parse,

fn parse_repeats( tokens: &mut TokenIter, min: usize, max: usize, ) -> Result<LazyVecUntil<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 LazyVecUntil<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.