Struct RecursionGuard 

pub struct RecursionGuard { /* private fields */ }

Tracks recursion depth during parsing.

This is a lightweight wrapper that parsers use to track and enforce recursion limits. It pairs with ParseConfig to provide the limit.

Example

struct MyParser {
    depth: RecursionGuard,
    config: ParseConfig,
}

impl MyParser {
    fn parse_nested(&mut self) -> Result<(), Error> {
        self.depth.enter(self.config.max_recursion_depth)?;
        // ... parse nested content ...
        self.depth.exit();
        Ok(())
    }
}

Implementations

impl RecursionGuard

pub const fn new() -> Self

Creates a new guard with depth 0.

pub const fn depth(&self) -> usize

Current recursion depth.

pub fn enter(&mut self, limit: usize) -> Result<(), Error>

Enter a nested context, incrementing depth.

Returns Err(Error::RecursionLimitExceeded) if the new depth would exceed the limit.

Arguments

• limit - Maximum allowed depth (from ParseConfig::max_recursion_depth)

pub fn exit(&mut self)

Exit a nested context, decrementing depth.

Uses saturating subtraction so extra exit() calls don’t underflow.

pub fn reset(&mut self)

Reset depth to zero.

Useful when reusing a parser for multiple inputs.

Trait Implementations

impl Clone for RecursionGuard

fn clone(&self) -> RecursionGuard

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RecursionGuard

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

Formats the value using the given formatter.

impl Default for RecursionGuard

fn default() -> RecursionGuard

Returns the “default value” for a type.

impl Copy for RecursionGuard