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

    pub struct PathAndQuery { /* fields omitted */ }

Represents the path component of a URI

## Implementations

### `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]

#### `fn clone(&self) -> PathAndQuery` [src]

Returns a copy of the value. Read more

#### `pub fn clone_from(&mut self, source: &Self)`1.0.0 [src]

Performs copy-assignment from `source`. Read more

### `impl Debug for PathAndQuery` [src]

#### `fn fmt(&self, f: &mut Formatter<'_>) -> Result` [src]

Formats the value using the given formatter. Read more

### `impl Display for PathAndQuery` [src]

#### `fn fmt(&self, fmt: &mut Formatter<'_>) -> Result` [src]

Formats the value using the given formatter. Read more

### `impl Eq for PathAndQuery` [src]

### `impl FromStr for PathAndQuery` [src]

#### `type Err = InvalidUri`

The associated error which can be returned from parsing.

#### `fn from_str(s: &str) -> Result<Self, InvalidUri>` [src]

Parses a string `s` to return a value of this type. Read more

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

#### `fn eq(&self, other: &&'a str) -> bool` [src]

This method tests for `self` and `other` values to be equal, and is used by `==`. Read more

#### `#[must_use]pub fn ne(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests for `!=`.

### `impl PartialEq<PathAndQuery> for PathAndQuery` [src]

#### `fn eq(&self, other: &PathAndQuery) -> bool` [src]

This method tests for `self` and `other` values to be equal, and is used by `==`. Read more

#### `#[must_use]pub fn ne(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests for `!=`.

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

#### `fn eq(&self, other: &PathAndQuery) -> bool` [src]

This method tests for `self` and `other` values to be equal, and is used by `==`. Read more

#### `#[must_use]pub fn ne(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests for `!=`.

### `impl PartialEq<PathAndQuery> for str` [src]

#### `fn eq(&self, other: &PathAndQuery) -> bool` [src]

This method tests for `self` and `other` values to be equal, and is used by `==`. Read more

#### `#[must_use]pub fn ne(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests for `!=`.

### `impl PartialEq<String> for PathAndQuery` [src]

#### `fn eq(&self, other: &String) -> bool` [src]

This method tests for `self` and `other` values to be equal, and is used by `==`. Read more

#### `#[must_use]pub fn ne(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests for `!=`.

### `impl PartialEq<str> for PathAndQuery` [src]

#### `fn eq(&self, other: &str) -> bool` [src]

This method tests for `self` and `other` values to be equal, and is used by `==`. Read more

#### `#[must_use]pub fn ne(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests for `!=`.

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

#### `fn partial_cmp(&self, other: &&'a str) -> Option<Ordering>` [src]

This method returns an ordering between `self` and `other` values if one exists. Read more

#### `#[must_use]pub fn lt(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests less than (for `self` and `other`) and is used by the `<` operator. Read more

#### `#[must_use]pub fn le(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests less than or equal to (for `self` and `other`) and is used by the `<=` operator. Read more

#### `#[must_use]pub fn gt(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests greater than (for `self` and `other`) and is used by the `>` operator. Read more

#### `#[must_use]pub fn ge(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests greater than or equal to (for `self` and `other`) and is used by the `>=` operator. Read more

### `impl PartialOrd<PathAndQuery> for PathAndQuery` [src]

#### `fn partial_cmp(&self, other: &PathAndQuery) -> Option<Ordering>` [src]

This method returns an ordering between `self` and `other` values if one exists. Read more

#### `#[must_use]pub fn lt(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests less than (for `self` and `other`) and is used by the `<` operator. Read more

#### `#[must_use]pub fn le(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests less than or equal to (for `self` and `other`) and is used by the `<=` operator. Read more

#### `#[must_use]pub fn gt(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests greater than (for `self` and `other`) and is used by the `>` operator. Read more

#### `#[must_use]pub fn ge(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests greater than or equal to (for `self` and `other`) and is used by the `>=` operator. Read more

### `impl PartialOrd<PathAndQuery> for str` [src]

#### `fn partial_cmp(&self, other: &PathAndQuery) -> Option<Ordering>` [src]

This method returns an ordering between `self` and `other` values if one exists. Read more

#### `#[must_use]pub fn lt(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests less than (for `self` and `other`) and is used by the `<` operator. Read more

#### `#[must_use]pub fn le(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests less than or equal to (for `self` and `other`) and is used by the `<=` operator. Read more

#### `#[must_use]pub fn gt(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests greater than (for `self` and `other`) and is used by the `>` operator. Read more

#### `#[must_use]pub fn ge(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests greater than or equal to (for `self` and `other`) and is used by the `>=` operator. Read more

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

#### `fn partial_cmp(&self, other: &PathAndQuery) -> Option<Ordering>` [src]

This method returns an ordering between `self` and `other` values if one exists. Read more

#### `#[must_use]pub fn lt(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests less than (for `self` and `other`) and is used by the `<` operator. Read more

#### `#[must_use]pub fn le(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests less than or equal to (for `self` and `other`) and is used by the `<=` operator. Read more

#### `#[must_use]pub fn gt(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests greater than (for `self` and `other`) and is used by the `>` operator. Read more

#### `#[must_use]pub fn ge(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests greater than or equal to (for `self` and `other`) and is used by the `>=` operator. Read more

### `impl PartialOrd<String> for PathAndQuery` [src]

#### `fn partial_cmp(&self, other: &String) -> Option<Ordering>` [src]

This method returns an ordering between `self` and `other` values if one exists. Read more

#### `#[must_use]pub fn lt(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests less than (for `self` and `other`) and is used by the `<` operator. Read more

#### `#[must_use]pub fn le(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests less than or equal to (for `self` and `other`) and is used by the `<=` operator. Read more

#### `#[must_use]pub fn gt(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests greater than (for `self` and `other`) and is used by the `>` operator. Read more

#### `#[must_use]pub fn ge(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests greater than or equal to (for `self` and `other`) and is used by the `>=` operator. Read more

### `impl PartialOrd<str> for PathAndQuery` [src]

#### `fn partial_cmp(&self, other: &str) -> Option<Ordering>` [src]

This method returns an ordering between `self` and `other` values if one exists. Read more

#### `#[must_use]pub fn lt(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests less than (for `self` and `other`) and is used by the `<` operator. Read more

#### `#[must_use]pub fn le(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests less than or equal to (for `self` and `other`) and is used by the `<=` operator. Read more

#### `#[must_use]pub fn gt(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests greater than (for `self` and `other`) and is used by the `>` operator. Read more

#### `#[must_use]pub fn ge(&self, other: &Rhs) -> bool` 1.0.0 [src]

This method tests greater than or equal to (for `self` and `other`) and is used by the `>=` operator. Read more

### `impl TryFrom<&'_ String> for PathAndQuery` [src]

#### `type Error = InvalidUri`

The type returned in the event of a conversion error.

#### `fn try_from(s: &String) -> Result<Self, Self::Error>` [src]

Performs the conversion.

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

#### `type Error = InvalidUri`

The type returned in the event of a conversion error.

#### `fn try_from(s: &'a [u8]) -> Result<Self, Self::Error>` [src]

Performs the conversion.

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

#### `type Error = InvalidUri`

The type returned in the event of a conversion error.

#### `fn try_from(s: &'a str) -> Result<Self, Self::Error>` [src]

Performs the conversion.

### `impl TryFrom<String> for PathAndQuery` [src]

#### `type Error = InvalidUri`

The type returned in the event of a conversion error.

#### `fn try_from(s: String) -> Result<Self, Self::Error>` [src]

Performs the conversion.

## 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]

#### `pub fn type_id(&self) -> TypeId` [src]

Gets the `TypeId` of `self`. Read more

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

#### `pub fn borrow(&self) -> &T` [src]

Immutably borrows from an owned value. Read more

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

#### `pub fn borrow_mut(&mut self) -> &mut T` [src]

Mutably borrows from an owned value. Read more

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

#### `pub fn from(t: T) -> T` [src]

Performs the conversion.

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

#### `pub fn into(self) -> U` [src]

Performs the conversion.

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

#### `type Owned = T`

The resulting type after obtaining ownership.

#### `pub fn to_owned(&self) -> T` [src]

Creates owned data from borrowed data, usually by cloning. Read more

#### `pub fn clone_into(&self, target: &mut T)` [src]

🔬 This is a nightly-only experimental API. (`toowned_clone_into`)

recently added

Uses borrowed data to replace owned data, usually by cloning. Read more

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

#### `pub default fn to_string(&self) -> String` [src]

Converts the given value to a `String`. Read more

### `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.

#### `pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>` [src]

Performs the conversion.

### `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.

#### `pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>` [src]

Performs the conversion.