Struct headers::common::etag::ETag

pub struct ETag(pub(super) EntityTag);

ETag header, defined in RFC7232

The ETag header field in a response provides the current entity-tag for the selected representation, as determined at the conclusion of handling the request. An entity-tag is an opaque validator for differentiating between multiple representations of the same resource, regardless of whether those multiple representations are due to resource state changes over time, content negotiation resulting in multiple representations being valid at the same time, or both. An entity-tag consists of an opaque quoted string, possibly prefixed by a weakness indicator.

ABNF

ETag       = entity-tag

Example values

• "xyzzy"
• W/"xyzzy"
• ""

Examples

let etag = "\"xyzzy\"".parse::<headers::ETag>().unwrap();

Tuple Fields

0: EntityTag

Trait Implementations

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 From<ETag> for IfMatch

fn from(etag: ETag) -> IfMatch

Converts to this type from the input type.

impl From<ETag> for IfNoneMatch

fn from(etag: ETag) -> IfNoneMatch

Converts to this type from the input type.

impl FromStr for ETag

type Err = InvalidETag

The associated error which can be returned from parsing.

fn from_str(src: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Header for ETag

fn name() -> &'static HeaderName

The name of this header.

fn decode<'i, I>(values: &mut I) -> Result<Self, Error>

where I: Iterator<Item = &'i HeaderValue>,

Decode this type from an iterator of HeaderValues.

fn encode<E: Extend<HeaderValue>>(&self, values: &mut E)

Encode this type to a HeaderMap.

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 Eq for ETag

impl StructuralPartialEq for ETag