Index

Struct Index 

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

Produces an index for each Element in the [`Document’]. Provides lookups for an element’s parent. This requires ownership of the document and pins the document.

§Example

use exile::Document;
let xml = "<a><b/><c><d>x</d><e/></c></a>";
let doc = exile::parse(xml).unwrap();

// create an index consuming the document
let index = doc.index();

// get the element at index 3 (depth-first numbering).
let d = index.element(3).unwrap();

// get that element's parent
let c = index.parent(&d).unwrap();

// prove it!
assert_eq!("c", c.name());

Implementations§

Source§

impl Index

Source

pub fn build(doc: Document) -> Self

Create an index from doc.

Source

pub fn doc(&self) -> &Document

Access the inner Document.

Source

pub fn root(&self) -> &Element

Access the root Element of the Document.

Source

pub fn into_doc(self) -> Document

Destroy the index and return ownership of the inner Document.

Source

pub fn element(&self, index: usize) -> Option<&Element>

Gets the element at index.

Source

pub fn index(&self, element: &Element) -> Option<usize>

Gets the index of the given element.

Source

pub fn parent(&self, element: &Element) -> Option<&Element>

Gets the parent of the given element.

Source

pub fn parent_index(&self, element: usize) -> Option<usize>

Gets the index of the parent of the element (which is given by index in this case).

Trait Implementations§

Source§

impl Clone for Index

Source§

fn clone(&self) -> Index

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Index

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl !Freeze for Index

§

impl !RefUnwindSafe for Index

§

impl !Send for Index

§

impl !Sync for Index

§

impl Unpin for Index

§

impl UnwindSafe for Index

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.