Struct Selectors 

pub struct Selectors { /* private fields */ }

A collection of Selector items (typically the matches of a CSS query) with batch operations.

Supports indexing (results[0]) and iteration by value or reference.

Implementations

impl Selectors

pub fn new(items: Vec<Selector>) -> Self

Create a new Selectors from a Vec of Selector.

pub fn len(&self) -> usize

Number of selectors in the collection.

pub fn is_empty(&self) -> bool

Whether the collection is empty.

pub fn first(&self) -> Option<&Selector>

Return the first selector, if any.

pub fn last(&self) -> Option<&Selector>

Return the last selector, if any.

pub fn css(&self, selector: &str) -> Selectors

Run a CSS selector against every item and flatten the results into one collection (order: all matches of the first item, then the second, and so on).

pub fn re( &self, pattern: &str, replace_entities: bool, clean_match: bool, case_sensitive: bool, ) -> Vec<TextHandler>

Apply a regex to every item’s recursive text and collect all matches (see Selector::re for the flag semantics).

pub fn re_first( &self, pattern: &str, replace_entities: bool, clean_match: bool, case_sensitive: bool, ) -> Option<TextHandler>

Apply a regex across the items in order and return the first match found in any of them.

pub fn get_first(&self, default: Option<TextHandler>) -> Option<TextHandler>

Recursive, stripped text of the first item (see Selector::get_all_text), or default when the collection is empty.

pub fn getall(&self) -> Vec<TextHandler>

Recursive, stripped text of every item, one entry per item.

pub fn search<F>(&self, func: F) -> Option<&Selector>

where F: Fn(&Selector) -> bool,

Return the first item matching a predicate, if any.

pub fn filter<F>(&self, func: F) -> Selectors

where F: Fn(&Selector) -> bool,

Keep only the items matching a predicate, returning a new Selectors (the original is unchanged).

Trait Implementations

impl Clone for Selectors

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Selectors

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

Formats the value using the given formatter.

impl Index<usize> for Selectors

type Output = Selector

The returned type after indexing.

fn index(&self, index: usize) -> &Self::Output

Performs the indexing (container[index]) operation.

impl IntoIterator for Selectors

type Item = Selector

The type of the elements being iterated over.

type IntoIter = IntoIter<Selector>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a> IntoIterator for &'a Selectors

type Item = &'a Selector

The type of the elements being iterated over.

type IntoIter = Iter<'a, Selector>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.