Struct surf::http::conditional::IfModifiedSince

pub struct IfModifiedSince { /* fields omitted */ }

Apply the HTTP method if the entity has been modified after the given date.

Specifications

• RFC 7232, section 3.3: If-Modified-Since

Examples

use http_types::Response;
use http_types::conditional::IfModifiedSince;
use std::time::{SystemTime, Duration};

let time = SystemTime::now() + Duration::from_secs(5 * 60);
let expires = IfModifiedSince::new(time);

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

let expires = IfModifiedSince::from_headers(res)?.unwrap();

// HTTP dates only have second-precision.
let elapsed = time.duration_since(expires.modified())?;
assert_eq!(elapsed.as_secs(), 0);

Implementations

impl IfModifiedSince

pub fn new(instant: SystemTime) -> IfModifiedSince

Create a new instance of IfModifiedSince.

pub fn modified(&self) -> SystemTime

Returns the last modification time listed.

pub fn from_headers(
    headers: impl AsRef<Headers>
) -> Result<Option<IfModifiedSince>, Error>

Create an instance of IfModifiedSince from a Headers instance.

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

Insert a HeaderName + HeaderValue pair into a Headers instance.

pub fn name(&self) -> HeaderName

Get the HeaderName.

pub fn value(&self) -> HeaderValue

Get the HeaderValue.

Trait Implementations

impl Debug for IfModifiedSince

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

Formats the value using the given formatter.

impl Eq for IfModifiedSince

impl Ord for IfModifiedSince

pub fn cmp(&self, other: &IfModifiedSince) -> Ordering

This method returns an Ordering between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl PartialEq<IfModifiedSince> for IfModifiedSince

pub fn eq(&self, other: &IfModifiedSince) -> bool

This method tests for self and other values to be equal, and is used by ==.

pub fn ne(&self, other: &IfModifiedSince) -> bool

This method tests for !=.

impl PartialOrd<IfModifiedSince> for IfModifiedSince

pub fn partial_cmp(&self, other: &IfModifiedSince) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

pub fn lt(&self, other: &IfModifiedSince) -> bool

This method tests less than (for self and other) and is used by the < operator.

pub fn le(&self, other: &IfModifiedSince) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

pub fn gt(&self, other: &IfModifiedSince) -> bool

This method tests greater than (for self and other) and is used by the > operator.

pub fn ge(&self, other: &IfModifiedSince) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralEq for IfModifiedSince

impl StructuralPartialEq for IfModifiedSince

impl ToHeaderValues for IfModifiedSince

type Iter = IntoIter<HeaderValue>

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

pub fn to_header_values(
    &self
) -> Result<<IfModifiedSince as ToHeaderValues>::Iter, Error>

Converts this object to an iterator of resolved HeaderValues.