Struct QueryMut 

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

Mutable view of a Uri’s query component.

Pushes append to the existing query, auto-encoding bytes outside the pair grammar. The first push promotes a None query to Some(empty) (i.e. adds a ? to the wire form). Drop releases the borrow.

Implementations

impl<'a> QueryMut<'a>

pub fn push_pair( &mut self, name: impl IntoUriComponent, value: impl IntoUriComponent, ) -> &mut Self

Append a name=value pair. Both name and value are percent-encoded under the pair policy (encode &, =, +, %, and everything outside pchar).

pub fn push_key(&mut self, name: impl IntoUriComponent) -> &mut Self

Append a bare key (no =). Same encoding policy as push_pair.

pub fn pop(&mut self) -> Option<QueryPair>

Remove and return the last pair as an owned QueryPair. Returns None when the query is empty or absent.

The pair’s bytes are sliced into a refcounted Bytes from the underlying query buffer — no copy.

pub fn drain(&mut self) -> Drain

Empty the query content and return an iterator yielding the removed pairs as owned QueryPairs.

The query stays Some(empty) after this — the ? remains on the wire. Call Uri::unset_query to remove the ? entirely.

pub fn retain( &mut self, keep: impl FnMut(QueryPairRef<'_>) -> bool, ) -> &mut Self

Keep only the pairs for which keep returns true, preserving their order and raw bytes. Empty &-fragments (&&, leading / trailing &) are dropped as part of the rebuild.

Like drain, the query stays Some(_) (the ? remains on the wire) even when every pair is removed.

pub fn remove(&mut self, name: impl IntoUriComponent) -> usize

Remove every pair whose form-decoded name equals name (bare keys included). Returns the number of pairs removed.

name is component text, compared form-decoded on both sides — see QueryRef::first_value for the matching rules.

pub fn set_pair( &mut self, name: impl IntoUriComponent, value: impl IntoUriComponent, ) -> &mut Self

Replace-or-append: remove every pair named name (form-decoded comparison, see remove), then append name=value under the push_pair encoding policy. The pair always ends up last, regardless of where the old ones sat.

Trait Implementations

impl Debug for QueryMut<'_>

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

Formats the value using the given formatter.