Struct StructuredError 

pub struct StructuredError {
    pub message: String,
    pub location: ErrorLocation,
    pub error_type: ValidationErrorType,
    pub level: ErrorLevel,
    pub node_name: Option<String>,
    pub expected: Option<String>,
    pub found: Option<String>,
}

Structured error for schema validation, compatible with libxml’s StructuredError.

Fields

message: String

Error message

location: ErrorLocation

Location information (line, column, byte_offset, xpath)

error_type: ValidationErrorType

Error type classification

level: ErrorLevel

Error severity level

node_name: Option<String>

Name of the element or attribute that caused the error

expected: Option<String>

Expected value or type (for type mismatch errors)

found: Option<String>

Actual value found (for type mismatch errors)

Implementations

impl StructuredError

pub fn new(message: impl Into<String>, error_type: ValidationErrorType) -> Self

Creates a new error with the given message and type.

pub fn with_line(self, line: usize) -> Self

Sets the line number.

pub fn with_column(self, column: usize) -> Self

Sets the column number.

pub fn with_byte_offset(self, offset: usize) -> Self

Sets the byte offset.

pub fn with_level(self, level: ErrorLevel) -> Self

Sets the error level.

pub fn with_element_path(self, path: impl Into<String>) -> Self

Sets the element path (stored in location.xpath).

pub fn with_node_name(self, name: impl Into<String>) -> Self

Sets the node name.

pub fn with_expected(self, expected: impl Into<String>) -> Self

Sets the expected value.

pub fn with_found(self, found: impl Into<String>) -> Self

Sets the found value.

pub fn is_warning(&self) -> bool

Returns true if this is a warning.

pub fn is_error(&self) -> bool

Returns true if this is an error or fatal.

pub fn with_location(self, location: &ErrorLocation) -> Self

Sets location information from an ErrorLocation (merges non-None fields).

pub fn set_location(self, location: ErrorLocation) -> Self

Sets the entire location, replacing any existing location.

pub fn line(&self) -> Option<usize>

Returns the line number (convenience accessor).

pub fn column(&self) -> Option<usize>

Returns the column number (convenience accessor).

pub fn byte_offset(&self) -> Option<usize>

Returns the byte offset (convenience accessor).

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

Returns the element path (convenience accessor).

pub fn calculate_line_column(self, input: &str) -> Self

Calculates and sets line/column from byte_offset using the given input.

This is useful when you have a byte offset but need to display line/column.

Trait Implementations

impl Clone for StructuredError

fn clone(&self) -> StructuredError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StructuredError

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

Formats the value using the given formatter.

impl Default for StructuredError

fn default() -> Self

Returns the “default value” for a type.

impl Display for StructuredError

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

Formats the value using the given formatter.

impl From<&StructuredError> for ErrorLocation

fn from(err: &StructuredError) -> Self

Converts to this type from the input type.