Struct Path

pub struct Path<T> { /* private fields */ }

Resource path match information.

If resource path contains variable patterns, Path stores them.

Implementations

impl<T> Path<T>

where T: ResourcePath,

pub fn new(path: T) -> Path<T>

pub fn get_ref(&self) -> &T

Returns reference to inner path instance.

pub fn get_mut(&mut self) -> &mut T

Returns mutable reference to inner path instance.

pub fn as_str(&self) -> &str

Returns full path as a string.

pub fn unprocessed(&self) -> &str

Returns unprocessed part of the path.

Returns empty string if no more is to be processed.

pub fn set(&mut self, path: T)

Set new path.

pub fn reset(&mut self)

Reset state.

pub fn skip(&mut self, n: u16)

Skip first n chars in path.

pub fn is_empty(&self) -> bool

Check if there are any matched patterns.

pub fn segment_count(&self) -> usize

Returns number of interpolated segments.

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

Get matched parameter by name without type conversion

pub fn query(&self, key: &str) -> &str

Returns matched parameter by name.

If keyed parameter is not available empty string is used as default value.

pub fn iter(&self) -> PathIter<'_, T>

Return iterator to items in parameter container.

pub fn load<'de, U>(&'de self) -> Result<U, Error>

where U: Deserialize<'de>,

Deserializes matching parameters to a specified type U.

Errors

Returns error when dynamic path segments cannot be deserialized into a U type.

Trait Implementations

impl<T> Clone for Path<T>

where T: Clone,

fn clone(&self) -> Path<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for Path<T>

where T: Debug,

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

Formats the value using the given formatter.

impl<T> Default for Path<T>

where T: Default,

fn default() -> Path<T>

Returns the “default value” for a type.

impl<'a, T> Index<&'a str> for Path<T>

where T: ResourcePath,

type Output = str

The returned type after indexing.

fn index(&self, name: &'a str) -> &str

Performs the indexing (container[index]) operation.

impl<T> Index<usize> for Path<T>

where T: ResourcePath,

type Output = str

The returned type after indexing.

fn index(&self, idx: usize) -> &str

Performs the indexing (container[index]) operation.

impl<T> Resource for Path<T>

where T: ResourcePath,

type Path = T

Type of resource’s path returned in resource_path.

fn resource_path(&mut self) -> &mut Path<<Path<T> as Resource>::Path>