Enum Error 

pub enum Error {
    Parse {
        position: Position,
        message: String,
        context: Option<ErrorContext>,
    },
    Scan {
        position: Position,
        message: String,
        context: Option<ErrorContext>,
    },
    Construction {
        position: Position,
        message: String,
        context: Option<ErrorContext>,
    },
    Emission {
        message: String,
    },
    Io {
        kind: ErrorKind,
        message: String,
    },
    Utf8 {
        message: String,
    },
    Type {
        expected: String,
        found: String,
        position: Position,
        context: Option<ErrorContext>,
    },
    Value {
        position: Position,
        message: String,
        context: Option<ErrorContext>,
    },
    Config {
        message: String,
    },
    Multiple {
        errors: Vec<Error>,
        message: String,
    },
    LimitExceeded {
        message: String,
    },
    Indentation {
        position: Position,
        expected: usize,
        found: usize,
        context: Option<ErrorContext>,
    },
    InvalidCharacter {
        position: Position,
        character: char,
        context_description: String,
        context: Option<ErrorContext>,
    },
    UnclosedDelimiter {
        start_position: Position,
        current_position: Position,
        delimiter_type: String,
        context: Option<ErrorContext>,
    },
}

Comprehensive error type for YAML processing

Variants

Parse

Parsing errors with position information

Fields

position: Position

Position where error occurred

message: String

Error message

context: Option<ErrorContext>

Additional context for better error reporting

Scan

Scanning errors during tokenization

Fields

position: Position

Position where error occurred

message: String

Error message

context: Option<ErrorContext>

Additional context for better error reporting

Construction

Construction errors when building objects

Fields

position: Position

Position where error occurred

message: String

Error message

context: Option<ErrorContext>

Additional context for better error reporting

Emission

Emission errors during output generation

Fields

message: String

Error message

Io

IO errors (simplified for clonability)

Fields

kind: ErrorKind

Error kind

message: String

Error message

Utf8

UTF-8 encoding errors

Fields

message: String

Error message

Type

Type conversion errors

Fields

expected: String

Expected type

found: String

Found type

position: Position

Position where error occurred

context: Option<ErrorContext>

Additional context for better error reporting

Value

Value errors for invalid values

Fields

position: Position

Position where error occurred

message: String

Error message

context: Option<ErrorContext>

Additional context for better error reporting

Config

Configuration errors

Fields

message: String

Error message

Multiple

Multiple related errors

Fields

errors: Vec<Error>

List of related errors

message: String

Context message

LimitExceeded

Resource limit exceeded

Fields

message: String

Error message describing which limit was exceeded

Indentation

Indentation errors

Fields

position: Position

Position where error occurred

expected: usize

Expected indentation level

found: usize

Found indentation level

context: Option<ErrorContext>

Additional context

InvalidCharacter

Invalid character or sequence

Fields

position: Position

Position where error occurred

character: char

The invalid character

context_description: String

Context where it was found

context: Option<ErrorContext>

Additional context

UnclosedDelimiter

Unclosed delimiter (quote, bracket, etc.)

Fields

start_position: Position

Position where delimiter started

current_position: Position

Position where EOF or mismatch was found

delimiter_type: String

Type of delimiter

context: Option<ErrorContext>

Additional context

Implementations

impl Error

pub fn parse(position: Position, message: impl Into<String>) -> Self

Create a new parse error

pub fn parse_with_context( position: Position, message: impl Into<String>, context: ErrorContext, ) -> Self

Create a new parse error with context

pub fn scan(position: Position, message: impl Into<String>) -> Self

Create a new scan error

pub fn scan_with_context( position: Position, message: impl Into<String>, context: ErrorContext, ) -> Self

Create a new scan error with context

pub fn construction(position: Position, message: impl Into<String>) -> Self

Create a new construction error

pub fn construction_with_context( position: Position, message: impl Into<String>, context: ErrorContext, ) -> Self

Create a new construction error with context

pub fn emission(message: impl Into<String>) -> Self

Create a new emission error

pub fn limit_exceeded(message: impl Into<String>) -> Self

Create a new limit exceeded error

pub fn type_error( position: Position, expected: impl Into<String>, found: impl Into<String>, ) -> Self

Create a new type error

pub fn type_error_with_context( position: Position, expected: impl Into<String>, found: impl Into<String>, context: ErrorContext, ) -> Self

Create a new type error with context

pub fn value_error(position: Position, message: impl Into<String>) -> Self

Create a new value error

pub fn value_error_with_context( position: Position, message: impl Into<String>, context: ErrorContext, ) -> Self

Create a new value error with context

pub fn config_error(message: impl Into<String>) -> Self

Create a new configuration error

pub fn config(message: impl Into<String>) -> Self

Legacy alias for config_error

pub fn multiple(errors: Vec<Self>, message: impl Into<String>) -> Self

Create a multiple error with related errors

pub const fn indentation( position: Position, expected: usize, found: usize, ) -> Self

Create an indentation error

pub const fn indentation_with_context( position: Position, expected: usize, found: usize, context: ErrorContext, ) -> Self

Create an indentation error with context

pub fn invalid_character( position: Position, character: char, context_description: impl Into<String>, ) -> Self

Create an invalid character error

pub fn invalid_character_with_context( position: Position, character: char, context_description: impl Into<String>, context: ErrorContext, ) -> Self

Create an invalid character error with context

pub fn unclosed_delimiter( start_position: Position, current_position: Position, delimiter_type: impl Into<String>, ) -> Self

Create an unclosed delimiter error

pub fn unclosed_delimiter_with_context( start_position: Position, current_position: Position, delimiter_type: impl Into<String>, context: ErrorContext, ) -> Self

Create an unclosed delimiter error with context

pub const fn position(&self) -> Option<&Position>

Get the position associated with this error, if any

pub const fn context(&self) -> Option<&ErrorContext>

Get the context associated with this error, if any

impl Error

fn format_with_context( &self, f: &mut Formatter<'_>, position: &Position, message: &str, context: Option<&ErrorContext>, ) -> Result

Format error with enhanced context display

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error for Error

fn custom<T: Display>(msg: T) -> Self

Used when a Serialize implementation encounters any error while serializing a type.

impl Error for Error

fn custom<T: Display>(msg: T) -> Self

Raised when there is general error when deserializing a type.

fn invalid_type(unexp: Unexpected<'_>, exp: &dyn Expected) -> Self

Raised when a Deserialize receives a type different from what it was expecting.

fn invalid_value(unexp: Unexpected<'_>, exp: &dyn Expected) -> Self

Raised when a Deserialize receives a value of the right type but that is wrong for some other reason.

fn invalid_length(len: usize, exp: &dyn Expected) -> Self

Raised when deserializing a sequence or map and the input data contains too many or too few elements.

fn unknown_variant(variant: &str, expected: &'static [&'static str]) -> Self

Raised when a Deserialize enum type received a variant with an unrecognized name.

fn unknown_field(field: &str, expected: &'static [&'static str]) -> Self

Raised when a Deserialize struct type received a field with an unrecognized name.

fn missing_field(field: &'static str) -> Self

Raised when a Deserialize struct type expected to receive a required field with a particular name but that field was not present in the input.

fn duplicate_field(field: &'static str) -> Self

Raised when a Deserialize struct type received more than one of the same field.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for Error

fn from(err: FromUtf8Error) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for Error

fn from(err: Utf8Error) -> Self

Converts to this type from the input type.

impl PartialEq for Error

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Error

impl StructuralPartialEq for Error