Struct CapturedFragment 

pub struct CapturedFragment<'tokens> { /* private fields */ }

One borrowed run of captured tokens under its original source boundary.

A fragment is a view into one CapturedInput or one captured group, never a second token tree. Its producer spans remain on the tokens it borrows, while its canonical bytes exclude those producer-local coordinates on the same terms as the complete capture.

Implementations

impl<'tokens> CapturedFragment<'tokens>

pub fn cursor(self) -> CaptureCursor<'tokens>

Open the generic mechanical cursor over this exact fragment.

impl<'tokens> CapturedFragment<'tokens>

pub const fn tokens(self) -> &'tokens [CapturedTokenTree]

The exact captured tokens this fragment borrows.

pub const fn len(self) -> usize

How many tokens this fragment carries at its current level.

pub const fn is_empty(self) -> bool

Whether this fragment carries no token at its current level.

pub fn first_span(self) -> Option<SpanHandle>

The first token’s producer span, where the fragment is nonempty.

pub fn last_span(self) -> Option<SpanHandle>

The last token’s producer span, where the fragment is nonempty.

pub const fn enclosing_span(self) -> Option<SpanHandle>

The enclosing group span used when a read reaches this fragment’s end.

A top-level fragment has no enclosing group and therefore answers None.

pub fn canonical_bytes(self) -> Vec<u8>

The canonical captured bytes of exactly this fragment.

Producer spans remain excluded, so a span-only movement does not move these bytes.

impl CapturedFragment<'_>

pub fn generated(self) -> Result<GeneratedTree, FragmentGenerationRefusal>

Project this exact captured fragment into one generated tree.

Every token is converted structurally. No inspected source string is built or parsed, and the captured fragment remains available with its original span handles.

Errors

Returns the exact captured span where an admitted generated literal or generated-token magnitude refuses.

Trait Implementations

impl<'tokens> Clone for CapturedFragment<'tokens>

fn clone(&self) -> CapturedFragment<'tokens>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'tokens> Copy for CapturedFragment<'tokens>

impl<'tokens> Debug for CapturedFragment<'tokens>

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

Formats the value using the given formatter.

impl<'tokens> Eq for CapturedFragment<'tokens>

impl<'tokens> Hash for CapturedFragment<'tokens>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'tokens> PartialEq for CapturedFragment<'tokens>

fn eq(&self, other: &CapturedFragment<'tokens>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<'tokens> StructuralPartialEq for CapturedFragment<'tokens>