Struct OwnedQuery

pub struct OwnedQuery { /* private fields */ }

Helper for query string parsing.

You may also need Query if you just want a borrowed version.

This is an auto-generated wrapper over Arc<HashMap<Arc<str>, Arc<str>, foldhash::fast::RandomState>>

Implementations

impl OwnedQuery

pub const fn new(inner: Arc<HashMap<Arc<str>, Arc<str>, RandomState>>) -> Self

Creates a new instance of OwnedQuery

impl OwnedQuery

pub fn parse_uri(uri: &Uri) -> Option<Self>

Parse query string from http::Uri.

pub fn get<Q>(&self, k: &Q) -> Option<&str>

where Arc<str>: Borrow<Q>, Q: Hash + Eq + ?Sized,

Since OwnedQuery is a wrapper of Arc<HashMap<Arc<str>, Arc<str>>> and implements Deref, without this you can still call HashMap::get (though auto deref), however you will get an Option<&Arc<str>>, and &Arc<str> is probably not what you want.

Here’s an example:

let data: OwnedQuery = ...;
let example = data.get("example").unwrap(); // &Arc<str>
assert!(example, "example");

assert!(example, "example") will not compile at all, you must change it to assert!(&**example, "example"):

& * *example
││└ &Arc<str> deref to Arc<str>
│└ Arc<str> deref to str
└ &str

This is really not convenient and graceful, so we provide this method as an replacement of HashMap::get. See The Rustonomicon - The Dot Operator for the reason why we can do so.

pub fn parse(query: &str) -> Self

Parse query string.

Trait Implementations

impl AsRef<Arc<HashMap<Arc<str>, Arc<str>, RandomState>>> for OwnedQuery

fn as_ref(&self) -> &Arc<HashMap<Arc<str>, Arc<str>, RandomState>>

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<Arc<HashMap<Arc<str>, Arc<str>, RandomState>>> for OwnedQuery

fn borrow(&self) -> &Arc<HashMap<Arc<str>, Arc<str>, RandomState>>

Immutably borrows from an owned value.

impl Clone for OwnedQuery

fn clone(&self) -> OwnedQuery

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for OwnedQuery

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

Formats the value using the given formatter.

impl Deref for OwnedQuery

type Target = Arc<HashMap<Arc<str>, Arc<str>, RandomState>>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for OwnedQuery

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl From<Arc<HashMap<Arc<str>, Arc<str>, RandomState>>> for OwnedQuery

fn from(inner: Arc<HashMap<Arc<str>, Arc<str>, RandomState>>) -> Self

Converts to this type from the input type.