Enum ParseError 

pub enum ParseError {
    Located {
        line: usize,
        column: usize,
        position: usize,
        message: String,
        hint: Option<String>,
    },
    UnexpectedToken {
        position: usize,
        expected: String,
        found: String,
    },
    UnexpectedEof,
    InvalidToken {
        position: usize,
        message: String,
    },
    InvalidNumber(String),
    InvalidDuration(String),
    InvalidTimestamp(String),
    UnterminatedString(usize),
    InvalidEscape(String),
    Custom {
        span: Span,
        message: String,
    },
}

Errors that can occur during VPL parsing.

Variants

Located

Error with precise source location and an optional hint for the user.

Fields

line: usize

1-based line number where the error occurred.

column: usize

1-based column number where the error occurred.

position: usize

0-based byte offset in the source string.

message: String

Human-readable description of the error.

hint: Option<String>

Optional suggestion for how to fix the error.

UnexpectedToken

An unexpected token was encountered during parsing.

Fields

position: usize

0-based byte offset of the unexpected token.

expected: String

Description of what was expected.

found: String

Description of what was found instead.

UnexpectedEof

The input ended unexpectedly (e.g., unclosed parenthesis).

InvalidToken

A token that does not belong to the VPL grammar was found.

Fields

position: usize

0-based byte offset of the invalid token.

message: String

Description of why the token is invalid.

InvalidNumber(String)

A numeric literal could not be parsed.

InvalidDuration(String)

A duration literal (e.g., 5s, 100ms) could not be parsed.

InvalidTimestamp(String)

A timestamp literal (e.g., @2024-01-15) could not be parsed.

UnterminatedString(usize)

A string literal was not closed before end of input.

Tuple Fields

0: usize

0-based byte offset where the string started.

InvalidEscape(String)

An unrecognized escape sequence was found inside a string literal.

Custom

A custom error with an associated source span.

Fields

span: Span

Source span where the error occurred.

message: String

Human-readable error message.

Implementations

impl ParseError

pub fn custom(span: Span, message: impl Into<String>) -> Self

Create a custom error from a source span and message.

pub fn at_location( source: &str, position: usize, message: impl Into<String>, hint: Option<String>, ) -> Self

Create an error with source location and optional hint

pub fn source_span(&self, source: &str) -> (usize, usize)

Extract the byte offset and length for highlighting in the source.

Returns (offset, length) where length defaults to 1 when only a point position is available.

pub fn hint(&self) -> Option<&str>

Return the hint text, if the variant carries one.

Trait Implementations

impl Clone for ParseError

fn clone(&self) -> ParseError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParseError

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

Formats the value using the given formatter.

impl Display for ParseError

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

Formats the value using the given formatter.

impl Error for ParseError

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.