Enum GraphQLTriviaToken 

pub enum GraphQLTriviaToken<'src> {
    Comment {
        value: Cow<'src, str>,
        span: ByteSpan,
    },
    Comma {
        span: ByteSpan,
    },
    Whitespace {
        value: Cow<'src, str>,
        span: ByteSpan,
    },
}

A “trivia token” is a token that doesn’t affect parsing but is still preserved (e.g. for tooling use).

Trivia includes comments, commas, and whitespace, which are attached to the following token as “preceding trivia”. This allows formatters and linters to preserve these elements without the parser needing to handle them explicitly.

Lifetime Parameter

The 'src lifetime enables zero-copy lexing for comment and whitespace values: StrGraphQLTokenSource can borrow text directly from the source.

Variants

Comment

A GraphQL comment, which starts with # and extends to the end of the line.

Fields

value: Cow<'src, str>

The comment text (excluding the leading #). Uses Cow<'src, str> to enable zero-copy lexing from string sources.

span: ByteSpan

The source location of the comment.

Comma

A comma separator. In GraphQL, commas are optional and treated as whitespace, but we preserve them as trivia.

Fields

span: ByteSpan

The source location of the comma.

Whitespace

A run of whitespace characters (spaces, tabs, newlines, BOM).

In GraphQL, whitespace is insignificant (it doesn’t affect parsing), but preserving it as trivia enables lossless source reconstruction. Each Whitespace trivia token captures a contiguous run of whitespace exactly as it appears in the source.

Fields

value: Cow<'src, str>

The whitespace text (spaces, tabs, newlines, BOM). Uses Cow<'src, str> to enable zero-copy lexing from string sources.

span: ByteSpan

The source location of the whitespace run.

Trait Implementations

impl<'src> Clone for GraphQLTriviaToken<'src>

fn clone(&self) -> GraphQLTriviaToken<'src>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'src> Debug for GraphQLTriviaToken<'src>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'src> PartialEq for GraphQLTriviaToken<'src>

fn eq(&self, other: &GraphQLTriviaToken<'src>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'src> StructuralPartialEq for GraphQLTriviaToken<'src>