Struct QueryPair 

pub struct QueryPair { /* private fields */ }

Available on crate feature net only.

One owned name[=value] pair, cheap to clone. Produced by QueryMut::pop and QueryMut::drain — popping a pair off a query doesn’t copy the byte content (the buffer is refcount-shared with the source).

Implementations

impl QueryPair

pub fn view(&self) -> QueryPairRef<'_>

Borrowed view. All inspection methods on QueryPair route through this — single source of truth for the slicing / decoding logic.

pub fn name_bytes(&self) -> &[u8]

Raw on-wire bytes of the name. See QueryPairRef::name_bytes.

pub fn name_raw(&self) -> &str

Name as &str with no decoding. Parser-validated UTF-8.

pub fn name_decoded(&self) -> Cow<'_, str>

Name with form-urlencoded decoding: + → space, %XX → byte. Cow::Borrowed when neither escape is present.

pub fn value_bytes(&self) -> Option<&[u8]>

Raw on-wire bytes of the value, or None for a bare key (?foo).

pub fn value_raw(&self) -> Option<&str>

Value as &str with no decoding, or None for a bare key.

pub fn value_decoded(&self) -> Option<Cow<'_, str>>

Value with form-urlencoded decoding (+ → space, %XX → byte), or None for a bare key.

pub fn has_value(&self) -> bool

true if the pair has an = separator. ?foo= → true; ?foo → false.

Trait Implementations

impl Clone for QueryPair

fn clone(&self) -> QueryPair

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueryPair

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

Formats the value using the given formatter.

impl FromIterator<QueryPair> for Query

fn from_iter<I>(iter: I) -> Query

where I: IntoIterator<Item = QueryPair>,

Build a Query by concatenating pre-encoded pair bytes with & separators. No re-encoding — the pairs’ bytes are assumed to already be in canonical on-wire form (which they are, when they come from QueryRef::pairs, QueryMut::pop or QueryMut::drain).

impl Hash for QueryPair

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for QueryPair

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

impl StructuralPartialEq for QueryPair