Struct Headers

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

A collection of headers

Implementations

impl Headers

pub fn new() -> Self

pub fn get_optional_string(&self, key: &HeaderName) -> Option<String>

Optionally get a header value as a String

pub fn get_str(&self, key: &HeaderName) -> Result<&str>

Get a header value as a str or error if it is not found

pub fn get_optional_str(&self, key: &HeaderName) -> Option<&str>

Optionally get a header value as a str

pub fn get_as<V, E>(&self, key: &HeaderName) -> Result<V>

where V: FromStr<Err = E>, E: Error + Send + Sync + 'static,

Get a header value parsing it as the type or error if it’s not found or it fails to parse

pub fn get_optional_as<V, E>(&self, key: &HeaderName) -> Result<Option<V>>

where V: FromStr<Err = E>, E: Error + Send + Sync + 'static,

Optionally get a header value parsing it as the type or error if it fails to parse

pub fn get_with<'a, V, F, E>(&'a self, key: &HeaderName, parser: F) -> Result<V>

where F: FnOnce(&'a HeaderValue) -> Result<V, E>, E: Error + Send + Sync + 'static,

Get a header value using the parser or error if it is not found or fails to parse

pub fn get_optional_with<'a, V, F, E>( &'a self, key: &HeaderName, parser: F, ) -> Result<Option<V>>

where F: FnOnce(&'a HeaderValue) -> Result<V, E>, E: Error + Send + Sync + 'static,

Optionally get a header value using the parser or error if it fails to parse

pub fn insert<K, V>(&mut self, key: K, value: V)

where K: Into<HeaderName>, V: Into<HeaderValue>,

Insert a header name/value pair

pub fn add<H>(&mut self, header: H)

where H: AsHeaders,

Add headers to the headers collection

pub fn iter(&self) -> impl Iterator<Item = (&HeaderName, &HeaderValue)>

Iterate over all the header name/value pairs

Trait Implementations

impl Clone for Headers

fn clone(&self) -> Headers

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Headers

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

Formats the value using the given formatter.

impl Default for Headers

fn default() -> Headers

Returns the “default value” for a type.

impl From<&Headers> for Metadata

fn from(header_map: &Headers) -> Self

Converts to this type from the input type.

impl From<HashMap<HeaderName, HeaderValue>> for Headers

fn from(c: HashMap<HeaderName, HeaderValue>) -> Self

Converts to this type from the input type.

impl From<Headers> for CustomHeaders

fn from(h: Headers) -> Self

Converts to this type from the input type.

impl IntoIterator for Headers

type Item = (HeaderName, HeaderValue)

The type of the elements being iterated over.

type IntoIter = IntoIter<HeaderName, HeaderValue>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for Headers

fn eq(&self, other: &Headers) -> 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 Eq for Headers

impl StructuralPartialEq for Headers