Struct PathParams 

pub struct PathParams { /* private fields */ }

Available on native and crate feature core only.

Ordered collection of path parameters extracted from a URL pattern.

Preserves insertion order so that tuple extractors like Path<(T1, T2)> can rely on URL pattern declaration order when populating tuple fields.

Example

use reinhardt_http::PathParams;

let mut params = PathParams::new();
params.insert("org", "myslug");
params.insert("cluster_id", "5");

// Insertion order is preserved.
let collected: Vec<_> = params.iter().map(|(k, v)| (k.as_str(), v.as_str())).collect();
assert_eq!(collected, vec![("org", "myslug"), ("cluster_id", "5")]);

// Named lookup still works.
assert_eq!(params.get("org").map(String::as_str), Some("myslug"));

Implementations

impl PathParams

pub fn new() -> PathParams

Create a new, empty PathParams.

pub fn with_capacity(capacity: usize) -> PathParams

Create an empty PathParams with capacity for capacity entries.

pub fn len(&self) -> usize

Number of stored parameters.

pub fn is_empty(&self) -> bool

true if no parameters are stored.

pub fn get(&self, key: &str) -> Option<&String>

Look up a parameter by name.

Returns the first match if multiple entries share the same name (which should not happen in practice because URL patterns require unique names).

pub fn insert(&mut self, key: impl Into<String>, value: impl Into<String>)

Insert or update a parameter.

If key already exists, its value is replaced and its position is kept. Otherwise the new entry is appended, preserving insertion order.

pub fn iter(&self) -> Iter<'_, (String, String)>

Iterate over (key, value) pairs in insertion order.

pub fn values(&self) -> impl Iterator<Item = &String>

Iterate over values in insertion order.

pub fn as_slice(&self) -> &[(String, String)]

Borrow the underlying ordered slice of (key, value) pairs.

pub fn into_vec(self) -> Vec<(String, String)>

Consume the wrapper and return the inner ordered Vec.

Trait Implementations

impl Clone for PathParams

fn clone(&self) -> PathParams

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PathParams

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 From<HashMap<String, String>> for PathParams

fn from(map: HashMap<String, String>) -> PathParams

Convert from a HashMap. Iteration order is not preserved because HashMap does not have a defined order. Prefer From<Vec<_>> when order matters.

impl From<Vec<(String, String)>> for PathParams

fn from(inner: Vec<(String, String)>) -> PathParams

Converts to this type from the input type.

impl<K, V> FromIterator<(K, V)> for PathParams

where K: Into<String>, V: Into<String>,

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

where I: IntoIterator<Item = (K, V)>,

Creates a value from an iterator.

impl IntoIterator for PathParams

type Item = (String, String)

The type of the elements being iterated over.

type IntoIter = IntoIter<(String, String)>

Which kind of iterator are we turning this into?

fn into_iter(self) -> <PathParams as IntoIterator>::IntoIter

Creates an iterator from a value.

impl<'a> IntoIterator for &'a PathParams

type Item = &'a (String, String)

The type of the elements being iterated over.

type IntoIter = Iter<'a, (String, String)>

Which kind of iterator are we turning this into?

fn into_iter(self) -> <&'a PathParams as IntoIterator>::IntoIter

Creates an iterator from a value.

impl PartialEq for PathParams

fn eq(&self, other: &PathParams) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PathParams