Enum PathParams 

pub enum PathParams<'a> {
    Borrowed(&'a [&'a str]),
    Owned(Vec<String>),
}

The path parameter values the router matched, in route-template order, as it decoded them. Empty for RPC. See Binding::path_params.

This is a small Cow-like enum instead of Cow<'a, [Cow<'a, str>]>. Cow names its owned form through <B as ToOwned>::Owned, and a lifetime inside that projection makes Binding invariant over 'a. The trait takes &'a Binding<'a>, so an invariant Binding would stop a generic caller from passing a &Binding<'_> it borrowed for a shorter time than the binding’s own lifetime. Here the borrowed form is a plain &'a [&'a str], which keeps Binding covariant. It also lets generated code, which knows a route’s parameter count, bind the values from a stack array without allocating.

Equality compares the values, not the variant, the way Cow’s does.

Variants

Borrowed(&'a [&'a str])

Borrowed from the router’s matched parameters. Borrowed(&[]), which PathParams::EMPTY and Default return, allocates nothing.

Owned(Vec<String>)

Owned values, for a Binding<'static> that outlives the request.

Implementations

impl PathParams<'_>

pub const EMPTY: PathParams<'static>

No parameters: every RPC binding, and a REST route without any.

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn iter(&self) -> impl ExactSizeIterator

The values in template order.

pub fn into_owned(self) -> PathParams<'static>

Detach from the request. Allocates one String per value, and nothing when there are none (an empty Vec does not allocate).

Trait Implementations

impl<'a> Clone for PathParams<'a>

fn clone(&self) -> PathParams<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for PathParams<'a>

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

Formats the value using the given formatter.

impl Default for PathParams<'_>

fn default() -> PathParams<'_>

Returns the “default value” for a type.

impl Eq for PathParams<'_>

impl PartialEq for PathParams<'_>

fn eq(&self, other: &PathParams<'_>) -> 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.