Struct htmldom_read::ChildrenFetch

pub struct ChildrenFetch<'a> { /* fields omitted */ }

Settings to fetch children nodes that apply to given criteria.

Examples

let html = r#"
<div id="mydiv">
    <p class="someclass">Text</p>
</div>
<a class="someclass else">link</a>
"#;

// Create node tree for HTML code.
let node = Node::from_html(html, &Default::default()).unwrap().unwrap();

// Create criteria. Find all `div` nodes with `id='mydiv'`.
let fetch = node.children_fetch()
        .tag("div")
        .key("id")
        .value("mydiv");

// Search for all children that apply to criteria.
let result = fetch.fetch();
// Returns the first node: `<div id='mydiv'>`.
assert_eq!(result.iter().nth(0).unwrap(), &node.children().get(0).unwrap());

// Search for all with class='someclass' allowing it to contain other classes too.
let fetch = node.children_fetch()
        .key("class")
        .value_part("someclass");
let result = fetch.fetch();
// Returns the nodes <p> and <a>.
assert_eq!(result.iter().nth(0).unwrap(),
        &node.children().get(0).unwrap().children().get(0).unwrap());
assert_eq!(result.iter().nth(1).unwrap(), &node.children().get(1).unwrap());

Methods

impl<'a> ChildrenFetch<'a>

pub fn for_node(node: &'a Node) -> Self

Get children fetcher for given node to find children that apply to some criteria.

pub fn same_for_node(&self, node: &'a Node) -> Self

Clone the fetcher with already set criteria but for given different node.

pub fn tag(self, tag: &'a str) -> Self

Tag to search for.

pub fn set_tag(&mut self, tag: &'a str)

pub fn key(self, key: &'a str) -> Self

Key to search for.

pub fn set_key(&mut self, key: &'a str)

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

Exact value to search for.

pub fn set_value(&mut self, value: &'a str)

pub fn value_part(self, part: &'a str) -> Self

If exact value is not set then this defines a part of the value separated with whitespaces to be found. If value is, however, set then this field is ignored entirely.

pub fn set_value_part(&mut self, part: &'a str)

pub fn fetch(self) -> LinkedList<&'a NodeAccess>

Get all children and their children that apply to the criteria. This function does not check the parent node!

Trait Implementations

impl<'a> Copy for ChildrenFetch<'a>

impl<'a> Clone for ChildrenFetch<'a>

fn clone(&self) -> ChildrenFetch<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for ChildrenFetch<'a>

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

Formats the value using the given formatter.