Struct Query

pub struct Query<'a> { /* private fields */ }

A set of QueryPairs, parsed from a query.

This is a multimap (one to many relation between keys and values) struct. A query can have multiple values per name. If we always use the first or last value of a name in a query, subtle exploits slip in. You have to make a explicit choice of what to do in this implementation.

Note that the order of the names in the Display implementation may be in the right order.

Implementations

impl<'a> Query<'a>

pub fn get_all(&self, name: &'a str) -> QueryPairIter<'_>

Returns a iterator of all values with name.

Don’t use this to get the first or last item; you’ll get the same drawbacks as Self::get_first and Self::get_last.

pub fn get(&self, name: &'a str) -> Option<&QueryPair<'_>>

Returns the value of name. This is the recommended method to get a QueryPair.

Note that this can return None even if name is present in the query.

If there exists multiple values associated with a name, None is returned.

pub fn get_first(&self, name: &'a str) -> Option<&QueryPair<'_>>

Gets the first value of name in the query. Consider using Self::get instead, as it eliminates risks for query attacks.

Watch this Youtube video to see how it can be exploited.

pub fn get_last(&self, name: &'a str) -> Option<&QueryPair<'_>>

Gets the last value of name in the query. Consider using Self::get instead, as it eliminates risks for query attacks.

Watch this Youtube video to see how it can be exploited.

Trait Implementations

impl<'a> Debug for Query<'a>

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

Formats the value using the given formatter.

impl Display for Query<'_>

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

Formats the value using the given formatter.

impl<'a> PartialEq for Query<'a>

fn eq(&self, other: &Query<'a>) -> 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> Eq for Query<'a>

impl<'a> StructuralPartialEq for Query<'a>