[][src]Struct http::uri::PathAndQuery

pub struct PathAndQuery { /* fields omitted */ }

Represents the path component of a URI

Methods

impl PathAndQuery[src]

pub fn from_static(src: &'static str) -> Self[src]

Convert a PathAndQuery from a static string.

This function will not perform any copying, however the string is checked to ensure that it is valid.

Panics

This function panics if the argument is an invalid path and query.

Examples

let v = PathAndQuery::from_static("/hello?world");

assert_eq!(v.path(), "/hello");
assert_eq!(v.query(), Some("world"));

pub fn from_maybe_shared<T>(src: T) -> Result<Self, InvalidUri> where
    T: AsRef<[u8]> + 'static, 
[src]

Attempt to convert a Bytes buffer to a PathAndQuery.

This will try to prevent a copy if the type passed is the type used internally, and will copy the data if it is not.

pub fn path(&self) -> &str[src]

Returns the path component

The path component is case sensitive.

abc://username:password@example.com:123/path/data?key=value&key2=value2#fragid1
                                       |--------|
                                            |
                                          path

If the URI is * then the path component is equal to *.

Examples


let path_and_query: PathAndQuery = "/hello/world".parse().unwrap();

assert_eq!(path_and_query.path(), "/hello/world");

pub fn query(&self) -> Option<&str>[src]

Returns the query string component

The query component contains non-hierarchical data that, along with data in the path component, serves to identify a resource within the scope of the URI's scheme and naming authority (if any). The query component is indicated by the first question mark ("?") character and terminated by a number sign ("#") character or by the end of the URI.

abc://username:password@example.com:123/path/data?key=value&key2=value2#fragid1
                                                  |-------------------|
                                                            |
                                                          query

Examples

With a query string component

let path_and_query: PathAndQuery = "/hello/world?key=value&foo=bar".parse().unwrap();

assert_eq!(path_and_query.query(), Some("key=value&foo=bar"));

Without a query string component

let path_and_query: PathAndQuery = "/hello/world".parse().unwrap();

assert!(path_and_query.query().is_none());

pub fn as_str(&self) -> &str[src]

Returns the path and query as a string component.

Examples

With a query string component

let path_and_query: PathAndQuery = "/hello/world?key=value&foo=bar".parse().unwrap();

assert_eq!(path_and_query.as_str(), "/hello/world?key=value&foo=bar");

Without a query string component

let path_and_query: PathAndQuery = "/hello/world".parse().unwrap();

assert_eq!(path_and_query.as_str(), "/hello/world");

Trait Implementations

impl Clone for PathAndQuery[src]

impl Debug for PathAndQuery[src]

impl Display for PathAndQuery[src]

impl Eq for PathAndQuery[src]

impl FromStr for PathAndQuery[src]

type Err = InvalidUri

The associated error which can be returned from parsing.

impl<'a> PartialEq<&'a str> for PathAndQuery[src]

impl PartialEq<PathAndQuery> for PathAndQuery[src]

impl<'a> PartialEq<PathAndQuery> for &'a str[src]

impl PartialEq<PathAndQuery> for str[src]

impl PartialEq<PathAndQuery> for String[src]

impl PartialEq<String> for PathAndQuery[src]

impl PartialEq<str> for PathAndQuery[src]

impl<'a> PartialOrd<&'a str> for PathAndQuery[src]

impl PartialOrd<PathAndQuery> for PathAndQuery[src]

impl PartialOrd<PathAndQuery> for str[src]

impl<'a> PartialOrd<PathAndQuery> for &'a str[src]

impl PartialOrd<PathAndQuery> for String[src]

impl PartialOrd<String> for PathAndQuery[src]

impl PartialOrd<str> for PathAndQuery[src]

impl<'a> TryFrom<&'a [u8]> for PathAndQuery[src]

type Error = InvalidUri

The type returned in the event of a conversion error.

impl<'a> TryFrom<&'a str> for PathAndQuery[src]

type Error = InvalidUri

The type returned in the event of a conversion error.

Auto Trait Implementations

impl RefUnwindSafe for PathAndQuery

impl Send for PathAndQuery

impl Sync for PathAndQuery

impl Unpin for PathAndQuery

impl UnwindSafe for PathAndQuery

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

impl<T> ToString for T where
    T: Display + ?Sized
[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.