Enum syn::punctuated::Pair

pub enum Pair<T, P> {
    Punctuated(T, P),
    End(T),
}

A single syntax tree node of type T followed by its trailing punctuation of type P if any.

Refer to the module documentation for details about punctuated sequences.

Variants

Punctuated(T, P)

End(T)

Implementations

impl<T, P> Pair<T, P>

pub fn into_value(self) -> T

Extracts the syntax tree node from this punctuated pair, discarding the following punctuation.

pub fn value(&self) -> &T

Borrows the syntax tree node from this punctuated pair.

pub fn value_mut(&mut self) -> &mut T

Mutably borrows the syntax tree node from this punctuated pair.

pub fn punct(&self) -> Option<&P>

Borrows the punctuation from this punctuated pair, unless this pair is the final one and there is no trailing punctuation.

pub fn punct_mut(&mut self) -> Option<&mut P>

Mutably borrows the punctuation from this punctuated pair, unless the pair is the final one and there is no trailing punctuation.

Example

punctuated.insert(0, parse_quote!('lifetime));
if let Some(punct) = punctuated.pairs_mut().next().unwrap().punct_mut() {
    punct.span = span;
}

pub fn new(t: T, p: Option<P>) -> Self

Creates a punctuated pair out of a syntax tree node and an optional following punctuation.

pub fn into_tuple(self) -> (T, Option<P>)

Produces this punctuated pair as a tuple of syntax tree node and optional following punctuation.

Trait Implementations

impl<T, P> Clone for Pair<T, P> where
    T: Clone,
    P: Clone, 

Available on crate feature clone-impls only.

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T, P> Extend<Pair<T, P>> for Punctuated<T, P>

fn extend<I: IntoIterator<Item = Pair<T, P>>>(&mut self, i: I)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬 This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬 This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl<T, P> FromIterator<Pair<T, P>> for Punctuated<T, P>

fn from_iter<I: IntoIterator<Item = Pair<T, P>>>(i: I) -> Self

Creates a value from an iterator.

impl<T, P> ToTokens for Pair<T, P> where
    T: ToTokens,
    P: ToTokens, 

Available on crate feature printing only.

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

Write self to the given TokenStream.

fn to_token_stream(&self) -> TokenStream

Convert self directly into a TokenStream object.

fn into_token_stream(self) -> TokenStream

Convert self directly into a TokenStream object.