Struct Query

pub struct Query<'x, N, F> { /* private fields */ }

A query for elements in Soup matching the Filter F

Trait Implementations

impl<N, F> Clone for Query<'_, N, F>

where F: Clone,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'x, N: Debug, F: Debug> Debug for Query<'x, N, F>

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

Formats the value using the given formatter.

impl<'x, N, F> IntoIterator for Query<'x, N, F>

where N: Node, F: Filter<N>,

type Item = QueryItem<'x, N>

The type of the elements being iterated over.

type IntoIter = QueryIter<'x, N, F>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'x, N, F> Queryable<'x> for Query<'x, N, F>

where N: Node, F: Filter<N>,

type Node = N

Query node type

type Filter = F

Already applied filter

fn recursive(self) -> Query<'x, N, F>

Allows the query to search the entire node tree

fn strict(self) -> Query<'x, N, F>

Forces the query to only match direct children of the root node

fn tag<T>(self, tag: T) -> Query<'x, N, And<F, Tag<T>>>

where T: Pattern<N::Text>, Tag<T>: Filter<N>,

Specifies a tag for which to search

fn attr<Q, V>(self, name: Q, value: V) -> Query<'x, N, And<F, Attr<Q, V>>>

where Q: Pattern<N::Text>, V: Pattern<N::Text>, Attr<Q, V>: Filter<N>,

Specifies an attribute name/value pair for which to search

fn attr_name<Q>( self, name: Q, ) -> Query<'x, Self::Node, And<Self::Filter, Attr<Q, bool>>>

where Q: Pattern<<Self::Node as Node>::Text>, Attr<Q, bool>: Filter<Self::Node>,

Searches for a tag that has an attribute with the specified name

fn attr_value<V>( self, value: V, ) -> Query<'x, Self::Node, And<Self::Filter, Attr<bool, V>>>

where V: Pattern<<Self::Node as Node>::Text>, Attr<bool, V>: Filter<Self::Node>,

Search for a node with any attribute with a value that matches the specified value

fn class<C>( self, class: C, ) -> Query<'x, Self::Node, And<Self::Filter, Attr<&'static str, C>>>

where C: Pattern<<Self::Node as Node>::Text>, <Self::Node as Node>::Text: AsRef<str> + From<&'static str>, Attr<&'static str, C>: Filter<Self::Node>,

Specifies a class name for which to search

fn first(self) -> Option<Self::Item>

where Self: IntoIterator,

Executes the query, and returns either the first result, or None

fn all(self) -> Self::IntoIter

where Self: IntoIterator,

Executes the query, and returns an iterator of the results

impl<N, F> Copy for Query<'_, N, F>

where F: Copy,