Struct PathMut 

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

Available on crate feature net only.

Mutable view of a Uri’s path component.

Holds the Owned representation of the URI for the guard’s lifetime. Each method modifies the path in place. Drop releases the borrow — no special finalization required.

Implementations

impl<'a> PathMut<'a>

pub fn push_segment( &mut self, segment: impl IntoUriComponent, ) -> &mut PathMut<'a>

Append a /-delimited segment, percent-encoding any bytes that aren’t legal in a URI path segment per RFC 3986.

Encodes: ASCII controls, space, ", #, %, /, <, >, ?, [, \, ], ^, `, {, |, }, and every non-ASCII byte. Passes through: ALPHA, DIGIT, -._~, !$&'()*+,;=, :, @. The % itself is encoded to %25 — pass already-decoded values, not pre-encoded ones.

If the current path doesn’t already end with /, one is inserted before the segment. Empty path + push_segment("x") yields /x. /foo + push_segment("bar") yields /foo/bar. /foo/ + push_segment("bar") yields /foo/bar (no double slash).

pub fn pop_segment(&mut self) -> Option<BytesMut>

Remove and return the last path segment.

/foo/bar → Some("bar"), path becomes /foo. /foo/ → Some(""), path becomes /foo. /foo → Some("foo"), path becomes empty. Empty path → None. Opaque paths (no /) → the whole path is returned.

The returned bytes are the raw on-wire form (still percent-encoded). Use PathSegment::as_decoded_str on the corresponding PathRef::segments item before mutation if you need the decoded value.

pub fn clear(&mut self) -> &mut PathMut<'a>

Clear the path entirely.

Trait Implementations

impl Debug for PathMut<'_>

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

Formats the value using the given formatter.