Struct Vary

pub struct Vary { /* private fields */ }

Apply the HTTP method if the ETag matches.

Specifications

• RFC 7231, section 7.1.4: Vary

Examples

use http_types::Response;
use http_types::conditional::Vary;

let mut entries = Vary::new();
entries.push("User-Agent")?;
entries.push("Accept-Encoding")?;

let mut res = Response::new(200);
entries.apply(&mut res);

let entries = Vary::from_headers(res)?.unwrap();
let mut entries = entries.iter();
assert_eq!(entries.next().unwrap(), "User-Agent");
assert_eq!(entries.next().unwrap(), "Accept-Encoding");

Implementations

impl Vary

pub fn new() -> Self

Create a new instance of Vary.

pub fn from_headers(headers: impl AsRef<Headers>) -> Result<Option<Self>>

Create a new instance from headers.

pub fn apply(&self, headers: impl AsMut<Headers>)

Sets the If-Match header.

pub fn name(&self) -> HeaderName

Get the HeaderName.

pub fn wildcard(&self) -> bool

Returns true if a wildcard directive was set.

pub fn set_wildcard(&mut self, wildcard: bool)

Set the wildcard directive.

pub fn value(&self) -> HeaderValue

Get the HeaderValue.

pub fn push(&mut self, directive: impl Into<HeaderName>) -> Result<()>

Push a directive into the list of entries.

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

An iterator visiting all server entries.

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

An iterator visiting all server entries.

Trait Implementations

impl Debug for Vary

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

Formats the value using the given formatter.

impl<'a> IntoIterator for &'a Vary

type Item = &'a HeaderName

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 Vary

type Item = &'a mut HeaderName

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.

impl IntoIterator for Vary

type Item = HeaderName

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

Creates an iterator from a value.

impl ToHeaderValues for Vary

type Iter = IntoIter<HeaderValue>

Returned iterator over header values which this type may correspond to.

fn to_header_values(&self) -> Result<Self::Iter>

Converts this object to an iterator of resolved HeaderValues.