Struct Attribute

pub struct Attribute<'a, 'input: 'a> { /* private fields */ }

An attribute.

Implementations

impl<'a, 'input> Attribute<'a, 'input>

pub fn namespace(&self) -> Option<&'a str>

Returns attribute’s namespace URI.

Examples

let doc = roxmltree::Document::parse(
    "<e xmlns:n='http://www.w3.org' a='b' n:a='c'/>"
).unwrap();

assert_eq!(doc.root_element().attributes().nth(0).unwrap().namespace(), None);
assert_eq!(doc.root_element().attributes().nth(1).unwrap().namespace(), Some("http://www.w3.org"));

pub fn name(&self) -> &'input str

Returns attribute’s name.

Examples

let doc = roxmltree::Document::parse(
    "<e xmlns:n='http://www.w3.org' a='b' n:a='c'/>"
).unwrap();

assert_eq!(doc.root_element().attributes().nth(0).unwrap().name(), "a");
assert_eq!(doc.root_element().attributes().nth(1).unwrap().name(), "a");

pub fn value(&self) -> &'a str

Returns attribute’s value.

Examples

let doc = roxmltree::Document::parse(
    "<e xmlns:n='http://www.w3.org' a='b' n:a='c'/>"
).unwrap();

assert_eq!(doc.root_element().attributes().nth(0).unwrap().value(), "b");
assert_eq!(doc.root_element().attributes().nth(1).unwrap().value(), "c");

pub fn value_storage(&self) -> &StringStorage<'input>

Returns attribute’s value storage.

Useful when you need a more low-level access to an allocated string.

pub fn position(&self) -> usize

Returns attribute’s position in bytes in the original document.

You can calculate a human-readable text position via Document::text_pos_at.

<e attr='value'/>
   ^

Trait Implementations

impl<'a, 'input: 'a> Clone for Attribute<'a, 'input>

fn clone(&self) -> Attribute<'a, 'input>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Attribute<'_, '_>

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

Formats the value using the given formatter.

impl PartialEq for Attribute<'_, '_>

fn eq(&self, other: &Attribute<'_, '_>) -> 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<'a, 'input: 'a> Copy for Attribute<'a, 'input>