Struct DateCache 

pub struct DateCache { /* private fields */ }

A Date value reformatted at most once per second.

A server writes date on every response; formatting it once per second instead of once per response saves the calendar arithmetic on all but the first response of each second. Keep one per thread or per connection driver: it is plain data, not shared state.

Examples

use http_net::DateCache;

let mut cache = DateCache::new();
assert_eq!(cache.update(784_111_777).as_str(), "Sun, 06 Nov 1994 08:49:37 GMT");
// Same second: the stored value, no formatting.
assert_eq!(cache.update(784_111_777).as_str(), "Sun, 06 Nov 1994 08:49:37 GMT");
assert_eq!(cache.update(784_111_778).as_str(), "Sun, 06 Nov 1994 08:49:38 GMT");

Implementations

impl DateCache

pub const fn new() -> Self

An empty cache; current shows the epoch until the first update.

Examples

let cache = http_net::DateCache::new();
assert_eq!(cache.current().as_str(), "Thu, 01 Jan 1970 00:00:00 GMT");

pub fn update(&mut self, unix_seconds: u64) -> &HttpDate

The value for unix_seconds, reformatted only when the second differs from the last update.

Examples

let mut cache = http_net::DateCache::new();
assert!(cache.update(1_000_000_000).as_str().contains("2001"));

pub const fn current(&self) -> &HttpDate

The value from the last update.

Examples

let mut cache = http_net::DateCache::new();
let _ = cache.update(86_400);
assert_eq!(cache.current().as_str(), "Fri, 02 Jan 1970 00:00:00 GMT");

Trait Implementations

impl Clone for DateCache

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DateCache

impl Debug for DateCache

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

Formats the value using the given formatter.

impl Default for DateCache

fn default() -> Self

Returns the “default value” for a type.

impl Eq for DateCache

impl PartialEq for DateCache

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DateCache