Struct NestingTooDeep 

pub struct NestingTooDeep {
    pub max_depth: usize,
    pub offset: usize,
    pub line: usize,
    pub column: usize,
    pub line_text: String,
}

A document that nests links deeper than the parser allows, with the position of the level that is one too deep.

Every parenthesized group and every indentation level is one level of nesting. The parser recurses once per level, so the limit is what turns a document that would overflow the stack, and abort the process, into an error.

Examples

use links_notation::{parse_lino_with_config, ParseError, ParserConfig};

let config = ParserConfig::new().with_max_depth(1);
assert!(parse_lino_with_config("(a (b))", &config).is_err());
let Err(ParseError::NestingTooDeep(error)) = parse_lino_with_config("((a))", &config) else {
    panic!("expected the nesting to be too deep")
};
assert_eq!((error.max_depth, error.line, error.column), (1, 1, 2));
assert_eq!(
    error.to_string(),
    "line 1, column 2: nesting depth exceeds the maximum of 1\n1 | ((a))\n  |  ^"
);

Fields

max_depth: usize

The deepest nesting the parser was configured to accept.

offset: usize

Byte offset of the offending position from the start of the document.

line: usize

Line the offending position is on, counted from 1.

column: usize

Column the offending position is at, in characters, counted from 1.

line_text: String

The offending line, as written, without its line ending.

Implementations

impl NestingTooDeep

pub fn summary(&self) -> String

The one-line summary: where the nesting got too deep and how deep it may go.

pub fn snippet(&self) -> String

The offending line with a caret under the offending column.

Trait Implementations

impl Clone for NestingTooDeep

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NestingTooDeep

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

Formats the value using the given formatter.

impl Display for NestingTooDeep

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

Formats the value using the given formatter.

impl Eq for NestingTooDeep

impl Error for NestingTooDeep

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for NestingTooDeep

fn eq(&self, other: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for NestingTooDeep