Struct http_types::headers::Headers

pub struct Headers { /* fields omitted */ }

A collection of HTTP Headers.

Methods

impl Headers

pub fn insert(
    &mut self,
    name: impl TryInto<HeaderName>,
    values: impl ToHeaderValues
) -> Result<Option<Vec<HeaderValue>>>

Insert a header into the headers.

pub fn append(
    &mut self,
    name: impl TryInto<HeaderName>,
    values: impl ToHeaderValues
) -> Result<()>

Append a header to the headers.

Unlike insert this function will not override the contents of a header, but insert a header if there aren't any. Or else append to the existing list of headers.

pub fn get(&self, name: &HeaderName) -> Option<&Vec<HeaderValue>>

Get a reference to a header.

pub fn get_mut(&mut self, name: &HeaderName) -> Option<&mut Vec<HeaderValue>>

Get a mutable reference to a header.

pub fn remove(&mut self, name: &HeaderName) -> Option<Vec<HeaderValue>>

Remove a header.

Important traits for Iter<'a>

impl<'a> Iterator for Iter<'a> type Item = (&'a HeaderName, &'a Vec<HeaderValue>);

pub fn iter<'a>(&'a self) -> Iter<'a>

An iterator visiting all header pairs in arbitrary order.

Important traits for IterMut<'a>

impl<'a> Iterator for IterMut<'a> type Item = (&'a HeaderName, &'a mut Vec<HeaderValue>);

pub fn iter_mut<'a>(&'a mut self) -> IterMut<'a>

An iterator visiting all header pairs in arbitrary order, with mutable references to the values.

Important traits for Names<'a>

impl<'a> Iterator for Names<'a> type Item = &'a HeaderName;

pub fn names<'a>(&'a self) -> Names<'a>

An iterator visiting all header names in arbitrary order.

Important traits for Values<'a>

impl<'a> Iterator for Values<'a> type Item = &'a HeaderValue;

pub fn values<'a>(&'a self) -> Values<'a>

An iterator visiting all header values in arbitrary order.

Trait Implementations

impl AsMut<Headers> for Request

fn as_mut(&mut self) -> &mut Headers

Performs the conversion.

impl AsMut<Headers> for Response

fn as_mut(&mut self) -> &mut Headers

Performs the conversion.

impl AsRef<Headers> for Request

fn as_ref(&self) -> &Headers

Performs the conversion.

impl AsRef<Headers> for Response

fn as_ref(&self) -> &Headers

Performs the conversion.

impl Debug for Headers

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

Formats the value using the given formatter.

impl IntoIterator for Headers

type Item = (HeaderName, Vec<HeaderValue>)

The type of the elements being iterated over.

type IntoIter = IntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Returns a iterator of references over the remaining items.

impl<'a> IntoIterator for &'a Headers

type Item = (&'a HeaderName, &'a Vec<HeaderValue>)

The type of the elements being iterated over.

type IntoIter = Iter<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a> IntoIterator for &'a mut Headers

type Item = (&'a HeaderName, &'a mut Vec<HeaderValue>)

The type of the elements being iterated over.

type IntoIter = IterMut<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.