Enum XmlEncodingError 

#[non_exhaustive]
pub enum XmlEncodingError {
    UnsupportedByteEncoding(&'static str),
    UnsupportedEncoding(String),
    ForbiddenEncoding(String),
    ConflictingEncoding(String),
    MalformedDeclaration(&'static str),
    InvalidBytes(&'static str),
    MissingUtf16ByteOrder,
    MissingUtf32ByteOrder,
    MissingEncodingDeclaration(&'static str),
    InvalidUtf16Length(&'static str),
    InvalidUtf32Length(&'static str),
    DecodedLimit {
        maximum: usize,
        actual: usize,
    },
}

Shared decoder errors, including unsupported encodings and decoded-size limits. This replaces the former XML-only error variants rather than collapsing new failure classes into misleading legacy variants. Failure while converting external bytes into the Unicode XML parser contract.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

UnsupportedByteEncoding(&'static str)

The byte signature selected an encoding that this implementation cannot decode.

UnsupportedEncoding(String)

An encoding label was not recognized.

ForbiddenEncoding(String)

The consuming XML format disallows the detected or declared encoding.

ConflictingEncoding(String)

Resolver metadata, a byte signature, and the XML declaration disagreed.

MalformedDeclaration(&'static str)

The XML declaration was malformed before parsing could begin.

InvalidBytes(&'static str)

The selected decoder rejected malformed input instead of replacing it.

MissingUtf16ByteOrder

A BOM-less UTF-16 document did not identify its byte order.

MissingUtf32ByteOrder

A UTF-32 document did not identify its byte order through metadata or its signature.

MissingEncodingDeclaration(&'static str)

A non-UTF-8/UTF-16 entity omitted both external encoding metadata and its declaration.

InvalidUtf16Length(&'static str)

A UTF-16 code unit was truncated.

InvalidUtf32Length(&'static str)

A UTF-32 code unit was truncated.

DecodedLimit

Decoded UTF-8 would exceed the caller’s materialization ceiling.

Fields

maximum: usize

Configured maximum decoded size.

actual: usize

Minimum decoded size required by the input.

Trait Implementations

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, __formatter: &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 From<Error> for XmlDocumentError

fn from(source: Error) -> Self

Converts to this type from the input type.