Enum xml_dom::level2::Error

#[repr(u16)]pub enum Error {
    IndexSize,
    StringSize,
    HierarchyRequest,
    WrongDocument,
    InvalidCharacter,
    NoDataAllowed,
    NoModificationAllowed,
    NotFound,
    NotSupported,
    InUseAttribute,
    InvalidState,
    Syntax,
    InvalidModification,
    Namespace,
    InvalidAccess,
}

Corresponds to the DOM DomException type.

Specification

DOM operations only raise exceptions in "exceptional" circumstances, i.e., when an operation is impossible to perform (either for logical reasons, because data is lost, or because the implementation has become unstable). In general, DOM methods return specific error values in ordinary processing situation, such as out-of-bound errors when using NodeList.

Variants

IndexSize

If index or size is negative, or greater than the allowed value

StringSize

If the specified range of text does not fit into a DOMString

HierarchyRequest

If any node is inserted somewhere it doesn't belong

WrongDocument

If a node is used in a different document than the one that created it (that doesn't support it)

InvalidCharacter

If an invalid or illegal character is specified, such as in a name. See production 2 in the XML specification for the definition of a legal character, and production 5 for the definition of a legal name character.

NoDataAllowed

If data is specified for a node which does not support data

NoModificationAllowed

If an attempt is made to modify an object where modifications are not allowed

NotFound

If an attempt is made to reference a node in a context where it does not exist

NotSupported

If the implementation does not support the requested type of object or operation

InUseAttribute

If an attempt is made to add an attribute that is already in use elsewhere

InvalidState

If an attempt is made to use an object that is not, or is no longer, usable (introduced in DOM Level 2)

Syntax

If an invalid or illegal string is specified (introduced in DOM Level 2)

InvalidModification

If an attempt is made to modify the type of the underlying object (introduced in DOM Level 2)

Namespace

If an attempt is made to create or change an object in a way which is incorrect with regard to namespaces (introduced in DOM Level 2)

InvalidAccess

If a parameter or an operation is not supported by the underlying object (introduced in DOM Level 2)

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy 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)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

fn description(&self) -> &str

Deprecated since 1.42.0:

use the Display impl or to_string()

if let Err(e) = "xc".parse::<u32>() { // Print e itself, no need for description(). eprintln!("Error: {}", e); }

fn cause(&self) -> Option<&dyn Error>

Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<Error> for Error

fn from(err: DOMError) -> Self

Performs the conversion.

impl<T> Into<Result<T, Error>> for Error

fn into(self) -> Result<T>

Performs the conversion.

impl PartialEq<Error> for Error

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl StructuralPartialEq for Error