Struct Host

pub struct Host { /* private fields */ }

The Host header.

HTTP/1.1 requires that all requests include a Host header, and so hyper client requests add one automatically.

Examples

use hyperx::header::{Host, TypedHeaders};

let mut headers = http::HeaderMap::new();
headers.encode(
    &Host::new("hyper.rs", None)
);

use hyperx::header::{Host, TypedHeaders};

let mut headers = http::HeaderMap::new();
headers.encode(
    &Host::new("hyper.rs", 8080)
);

Implementations

impl Host

pub fn new<H, P>(hostname: H, port: P) -> Host

where H: Into<Cow<'static, str>>, P: Into<Option<u16>>,

Create a Host header, providing the hostname and optional port.

pub fn hostname(&self) -> &str

Get the hostname, such as example.domain.

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

Get the optional port number.

Trait Implementations

impl Clone for Host

fn clone(&self) -> Host

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Host

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

Formats the value using the given formatter.

impl Display for Host

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

Formats the value using the given formatter.

impl FromStr for Host

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Host>

Parses a string s to return a value of this type.

impl Header for Host

fn header_name() -> &'static str

Returns the name of the header field this belongs to.

fn parse_header<'a, T>(raw: &'a T) -> Result<Host>

where T: RawLike<'a>,

Parse a header from a raw stream of bytes.

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

Format a header to outgoing stream.

impl PartialEq for Host

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StandardHeader for Host

fn http_header_name() -> HeaderName

The HeaderName from the http crate for this header.

impl StructuralPartialEq for Host