Enum XmlError 

pub enum XmlError {
    InvalidXml(String),
    MissingRequiredElement(String),
    UnknownElement(String),
    BadEnum(String),
    CircularInheritance(String),
    ValueOutOfRange(String),
    LimitExceeded(String),
    UnresolvedReference(String),
}

Error while parsing or resolving a DDS-XML document.

Spec source: OMG DDS-XML 1.0 §7.1 (XML Representation Syntax) and §7.2 (XML Representation of DDS IDL PSM).

Variants

InvalidXml(String)

XML is not well-formed per [XML] §2.1.

Spec ref: DDS-XML 1.0 §7.1.1 (“XML shall be well-formed”).

MissingRequiredElement(String)

An element mandatory per spec table 7.2 / 7.3.x is missing.

Spec ref: DDS-XML 1.0 §7.1.4 Tab.7.1, §7.2.x.

UnknownElement(String)

An element not present in the element table 7.1/7.2/7.3 was found. Strict mode rejects; lax mode ignores.

Spec ref: DDS-XML 1.0 §7.1.4 (element value table).

BadEnum(String)

Enum string does not fit the DCPS-IDL whitelist (Spec §7.1.4 Tab.7.1 — enum values are string literals, not numeric).

Spec ref: DDS-XML 1.0 §7.1.4 Tab.7.1 (enum), §7.2.1.

CircularInheritance(String)

base_name inheritance forms a cycle (A inherits from B inherits from A).

Spec ref: DDS-XML 1.0 §7.3.2.4.2 (QoS Profile Inheritance — “shall only inherit from previously defined profiles”). Naive implementations can create cycles across library boundaries; the loader therefore performs DAG checking.

ValueOutOfRange(String)

Element value outside the spec value range (e.g. long > 0x7fffffff without symbol aliasing).

Spec ref: DDS-XML 1.0 §7.1.4 Tab.7.1 (value ranges), §7.2.2 (LENGTH_UNLIMITED, DURATION_INFINITE_*).

LimitExceeded(String)

DoS cap hit — list/string exceeds the upper bound configured in the loader (default: 1024 list elements, 64 KiB strings).

No direct spec reference; follows the ZeroDDS security posture (docs/spec-coverage/zerodds-xml-1.0.open.md risks section).

UnresolvedReference(String)

A cross-reference (e.g. base_name of a QoS profile inheritance) could not be resolved because the referenced item does not exist.

Spec ref: DDS-XML 1.0 §7.3.2.4.2 (QoS profile inheritance).

Trait Implementations

impl Clone for XmlError

fn clone(&self) -> XmlError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for XmlError

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

Formats the value using the given formatter.

impl Display for XmlError

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

Formats the value using the given formatter.

impl Eq for XmlError

impl Error for XmlError

Available on crate feature std only.

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 PartialEq for XmlError

fn eq(&self, other: &XmlError) -> 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 StructuralPartialEq for XmlError