Struct HostName 

pub struct HostName(/* private fields */);

A validated hostname.

The inner bytes are private and the only public constructor checks them. That is what stops a caller from putting a CRLF in a host and injecting a header through the Request-URI: without this, Host::Name(b"evil\r\nInjected: yes") would serialize into a perfectly convincing forged request line.

Implementations

impl HostName

pub fn new(name: impl Into<Bytes>) -> Result<Self, BuildError>

Validate a hostname.

pub fn as_bytes(&self) -> &[u8]

The hostname.

Trait Implementations

impl Clone for HostName

fn clone(&self) -> HostName

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HostName

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

Formats the value using the given formatter.

impl PartialEq<&[u8]> for HostName

fn eq(&self, other: &&[u8]) -> 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 PartialEq<&str> for HostName

fn eq(&self, other: &&str) -> 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.