Struct typed_headers::Host

pub struct Host { /* fields omitted */ }

The Host header, defined in RFC7230.

The "Host" header field in a request provides the host and port information from the target URI, enabling the origin server to distinguish among resources while servicing requests for multiple host names on a single IP address.

ABNF

Host = uri-host [ ":" port ]

Methods

impl Host

pub fn new(host: &str, port: Option<u16>) -> Result<Host, Error>

Creates a Host header from a hostname and optional port.

pub fn from_authority(authority: &Authority) -> Host

Creates a Host header from a URI authority component.

The userinfo portion of the authority is not included in the header.

pub fn host(&self) -> &str

Returns the host.

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

Returns the port.

Trait Implementations

impl Header for Host

fn name() -> &'static HeaderName

Returns the name of this header.

fn from_values<'a>(
    values: &mut ValueIter<'a, HeaderValue>
) -> Result<Option<Host>, Error>

Parses the header from the raw value bytes.

fn to_values(&self, values: &mut ToValues)

Serializes the header to raw values.

impl Clone for Host

fn clone(&self) -> Host

Returns a copy of the value.

default 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.