Struct hyperx::header::Host

pub struct Host { /* fields omitted */ }

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

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

use hyperx::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))
);

Methods

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

fn http_header_name() -> HeaderName

The HeaderName from the http crate for this header.

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

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

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

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

This method tests for !=.

impl Display for Host

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

Formats the value using the given formatter.

impl Debug 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.