Struct hyper::header::Host

[+] Show declaration

pub struct Host { /* fields omitted */ }

[−] Expand description

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))
);

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 Clone for Host[+]

[+] Show hidden undocumented items

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[+]

[+] Show hidden undocumented items

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

Formats the value using the given formatter.

impl Display for Host[+]

[+] Show hidden undocumented items

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

Formats the value using the given formatter.

impl FromStr for Host[+]

[+] Show hidden undocumented items

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[+]

[+] Show hidden undocumented items

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<Host> for Host[+]

[+] Show hidden undocumented items

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