Skip to main content

Element

Struct Element 

Source
pub struct Element { /* private fields */ }
Expand description

An XML element retaining names, namespace resolution, attributes, and order.

Equality compares semantic identity and content only. Source spans are provenance for the exact writer, so two elements parsed from differently spelled but equivalent syntax remain equal.

Implementations§

Source§

impl Element

Source

pub fn new( namespace: Option<&str>, prefix: Option<&str>, local_name: &str, ) -> Self

Builds a fresh element with no retained source provenance.

namespace is the element’s resolved namespace URI, independent of prefix. Elements built this way carry no spans, so Document::to_xml_string works on them but Document::to_xml_string_exact fails closed with ExactWriteError::NoSource — there is no retained source to slice. This constructor does not emit an xmlns declaration for namespace; use Document::standalone to wrap a built root with the xmlns:dt binding codecs need.

Source

pub fn with_attribute(self, attribute: Attribute) -> Self

Appends an attribute, returning self for chained construction.

Source

pub fn with_child(self, child: Element) -> Self

Appends a child element as a node, returning self for chained construction.

Source

pub fn with_text(self, text: impl Into<String>) -> Self

Appends a text node, returning self for chained construction.

Source

pub fn qname(&self) -> &str

Source

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

Source

pub fn local_name(&self) -> &str

Source

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

Source

pub fn attributes(&self) -> &[Attribute]

Source

pub fn nodes(&self) -> &[Node]

Source

pub const fn was_empty_element(&self) -> bool

Whether the source used an empty-element tag such as <dt:Property/>.

Source

pub fn children(&self) -> impl Iterator<Item = &Element>

Direct child elements in document order.

Source

pub fn attribute_ns( &self, namespace_uri: Option<&str>, local_name: &str, ) -> Option<&str>

Finds an attribute by resolved namespace URI and local name.

Source

pub fn direct_text(&self) -> String

Direct semantic text and CDATA content, preserving order.

Trait Implementations§

Source§

impl Clone for Element

Source§

fn clone(&self) -> Element

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Element

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Eq for Element

Source§

impl PartialEq for Element

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.