Struct QueryMut 

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

Available on crate feature http only.

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 QueryMut<'a>

Available on crate feature net only.

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 QueryMut<'a>

Available on crate feature net only.

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

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

Available on crate feature net only.

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

Available on crate feature net only.

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.

Trait Implementations

impl Debug for QueryMut<'_>

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

Formats the value using the given formatter.