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 hyper::header::{Headers, Host};

let mut headers = Headers::new();
headers.set(
    Host::new("hyper.rs", None)
);

use hyper::header::{Headers, Host};

let mut headers = Headers::new();
headers.set(
    // In Rust 1.12+
    // Host::new("hyper.rs", 8080)
    Host::new("hyper.rs", Some(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 copy 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(raw: &Raw) -> Result<Host>

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 StructuralPartialEq for Host