Module syn::punctuated

A punctuated sequence of syntax tree nodes separated by punctuation.

Lots of things in Rust are punctuated sequences.

• The fields of a struct are Punctuated<Field, Token![,]>.
• The segments of a path are Punctuated<PathSegment, Token![::]>.
• The bounds on a generic parameter are Punctuated<TypeParamBound, Token![+]>.
• The arguments to a function call are Punctuated<Expr, Token![,]>.

This module provides a common representation for these punctuated sequences in the form of the Punctuated<T, P> type. We store a vector of pairs of syntax tree node + punctuation, where every node in the sequence is followed by punctuation except for possibly the final one.

a_function_call(arg1, arg2, arg3);
                ~~~~^ ~~~~^ ~~~~

Structs

• IntoIter
  An iterator over owned values of type T.
• IntoPairs
  An iterator over owned pairs of type Pair<T, P>.
• Iter
  An iterator over borrowed values of type &T.
• IterMut
  An iterator over mutably borrowed values of type &mut T.
• Pairs
  An iterator over borrowed pairs of type Pair<&T, &P>.
• PairsMut
  An iterator over mutably borrowed pairs of type Pair<&mut T, &mut P>.
• Punctuated
  A punctuated sequence of syntax tree nodes of type T separated by punctuation of type P.

Enums

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