Module 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.