Struct trillium_http_types::conditional::IfNoneMatch

pub struct IfNoneMatch { /* fields omitted */ }

Apply the HTTP method if the ETags do not match.

This is used to update caches or to prevent uploading a new resource when one already exists.

Specifications

• RFC 7232, section 3.2: If-None-Match

Examples

use http_types::Response;
use http_types::conditional::{IfNoneMatch, ETag};

let mut entries = IfNoneMatch::new();
entries.push(ETag::new("0xcafebeef".to_string()));
entries.push(ETag::new("0xbeefcafe".to_string()));

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

let entries = IfNoneMatch::from_headers(res)?.unwrap();
let mut entries = entries.iter();
assert_eq!(entries.next().unwrap(), &ETag::new("0xcafebeef".to_string()));
assert_eq!(entries.next().unwrap(), &ETag::new("0xbeefcafe".to_string()));

Implementations

impl IfNoneMatch

pub fn new() -> Self

Create a new instance of IfNoneMatch.

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

Create a new instance from headers.

pub fn push(&mut self, directive: impl Into<ETag>)

Push a directive into the list of entries.

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 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 IfNoneMatch

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

Formats the value using the given formatter.

impl Header for IfNoneMatch

fn header_name(&self) -> HeaderName

Access the header’s name.

fn header_value(&self) -> HeaderValue

Access the header’s value.

fn apply_header<H: AsMut<Headers>>(&self, headers: H)

Insert the header name and header value into something that looks like a Headers map.

impl IntoIterator for IfNoneMatch

type Item = ETag

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<'a> IntoIterator for &'a IfNoneMatch

type Item = &'a ETag

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 IfNoneMatch

type Item = &'a mut ETag

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.