Struct vstorage::Etag

pub struct Etag(/* private fields */);

An identifier for a specific version of a resource.

Each time that a resource is read, it will return its current Etag. The Etag is a unique identifier for the current version. An Etag value is specific to a specific storage implementation and instance. E.g.: they are opaque values that have no meaning across storages.

This is strongly inspired on the HTTP header of the same name.

It is assumed that all Etag values are valid UTF-8 strings. As of HTTP 1.1, all header values are restricted to visible characters in the ASCII range, so this is not a problem for CalDav or CardDav storages. Other storages with no native Etag concept should attempt to use the most suitable approximation.

Implementations

impl Etag

pub fn as_str(&self) -> &str

Trait Implementations

impl AsRef<str> for Etag

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Etag

fn clone(&self) -> Etag

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Etag

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

Formats the value using the given formatter.

impl Display for Etag

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

Formats the value using the given formatter.

impl<T> From<T> for Etag

where String: From<T>,

fn from(value: T) -> Self

Converts to this type from the input type.

impl PartialEq for Etag

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Etag