Struct hyper::client::connect::Destination

source · [−]

pub struct Destination { /* private fields */ }

Expand description

A set of properties to describe where and how to try to connect.

This type is passed an argument for the Connect trait.

Implementations

impl Destination

pub fn try_from_uri(uri: Uri) -> Result<Self>

Try to convert a Uri into a Destination

Error

Returns an error if the uri contains no authority or no scheme.

pub fn scheme(&self) -> &str

Get the protocol scheme.

pub fn host(&self) -> &str

Get the hostname.

pub fn port(&self) -> Option<u16>

Get the port, if specified.

pub fn set_scheme(&mut self, scheme: &str) -> Result<()>

Update the scheme of this destination.

Example

// let mut dst = some_destination...
// Change from "http://"...
assert_eq!(dst.scheme(), "http");

// to "ws://"...
dst.set_scheme("ws");
assert_eq!(dst.scheme(), "ws");

Error

Returns an error if the string is not a valid scheme.

pub fn set_host(&mut self, host: &str) -> Result<()>

Update the host of this destination.

Example

// let mut dst = some_destination...
// Change from "hyper.rs"...
assert_eq!(dst.host(), "hyper.rs");

// to "some.proxy"...
dst.set_host("some.proxy");
assert_eq!(dst.host(), "some.proxy");

Error

Returns an error if the string is not a valid hostname.

pub fn set_port<P>(&mut self, port: P) where
P: Into<Option<u16>>,

Update the port of this destination.

Example

// let mut dst = some_destination...
// Change from "None"...
assert_eq!(dst.port(), None);

// to "4321"...
dst.set_port(4321);
assert_eq!(dst.port(), Some(4321));

// Or remove the port...
dst.set_port(None);
assert_eq!(dst.port(), None);

Trait Implementations

impl Clone for Destination

fn clone(&self) -> Destination

Returns a copy of the value. Read more

1.0.0 · source

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

Performs copy-assignment from source. Read more

impl Debug for Destination

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

Formats the value using the given formatter. Read more

impl TryFrom<Uri> for Destination

type Error = Error

The type returned in the event of a conversion error.

fn try_from(uri: Uri) -> Result<Self, Self::Error>

Performs the conversion.

Auto Trait Implementations

impl RefUnwindSafe for Destination

impl Send for Destination

impl Sync for Destination

impl Unpin for Destination

impl UnwindSafe for Destination

Blanket Implementations

impl<T> Any for T where
T: 'static + ?Sized,

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

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

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

const: unstable · source

pub fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into<U> for T where
U: From<T>,

const: unstable · source

pub fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

pub fn to_owned(&self) -> T

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

pub fn clone_into(&self, target: &mut T)

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

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

impl<T, U> TryFrom<U> for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

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

The type returned in the event of a conversion error.

const: unstable · source

pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.