StructureGrammar

ParsingError

An error type that indicates the furthest-successful parse, and provides a stack trace detailing how the parser got there.

@frozen struct ParsingError<Index>

Overview

None of the structured parsers defined in swift-grammar throw this error directly. Instead, the DefaultDiagnostics engine computes it based on the diagnostic engine’s internal state when encountering invalid input.

Custom ParsingRule implementations should not throw this error either.

Members

Initializers

init(at: Index, because: Error, trace: [ParsingError<Index>.Frame])

Type Properties

static var namespace: String
Returns the string "parsing error".

Instance Properties

var context: [String]
var description: String
A textual representation of this instance.
var halfWidthCornerQuoted: String
let index: Index
The index of the first invalid terminal in the input, or the endIndex of the input.
var next: Error?
let problem: Error
The underlying parsing error.
let trace: [ParsingError<Index>.Frame]

Instance Methods

func annotate<Background>(source: Background, line: (Background.SubSequence) -> String, newline: (Background.Element) -> Bool) -> String

Structures

struct Frame
A diagnostic stack frame, corresponding to a structured ParsingRule invocation.