[][src]Struct rocket::http::hyper::header::EntityTag

pub struct EntityTag {
    pub weak: bool,
    // some fields omitted
}

An entity tag, defined in RFC7232

An entity tag consists of a string enclosed by two literal double quotes. Preceding the first double quote is an optional weakness indicator, which always looks like W/. Examples for valid tags are "xyzzy" and W/"xyzzy".

ABNF

entity-tag = [ weak ] opaque-tag
weak       = %x57.2F ; "W/", case-sensitive
opaque-tag = DQUOTE *etagc DQUOTE
etagc      = %x21 / %x23-7E / obs-text
           ; VCHAR except double quotes, plus obs-text

Comparison

To check if two entity tags are equivalent in an application always use the strong_eq or weak_eq methods based on the context of the Tag. Only use == to check if two tags are identical.

The example below shows the results for a set of entity-tag pairs and both the weak and strong comparison function results:

ETag 1 ETag 2 Strong Comparison Weak Comparison
W/"1" W/"1" no match match
W/"1" W/"2" no match no match
W/"1" "1" no match match
"1" "1" match match

Fields

Weakness indicator for the tag

Methods

impl EntityTag
[src]

Constructs a new EntityTag.

Panics

If the tag contains invalid characters.

Constructs a new weak EntityTag.

Panics

If the tag contains invalid characters.

Constructs a new strong EntityTag.

Panics

If the tag contains invalid characters.

Get the tag.

Set the tag.

Panics

If the tag contains invalid characters.

For strong comparison two entity-tags are equivalent if both are not weak and their opaque-tags match character-by-character.

For weak comparison two entity-tags are equivalent if their opaque-tags match character-by-character, regardless of either or both being tagged as "weak".

The inverse of EntityTag.strong_eq().

The inverse of EntityTag.weak_eq().

Trait Implementations

impl FromStr for EntityTag
[src]

The associated error which can be returned from parsing.

impl PartialEq<EntityTag> for EntityTag
[src]

impl Clone for EntityTag
[src]

Performs copy-assignment from source. Read more

impl Display for EntityTag
[src]

impl Eq for EntityTag
[src]

impl Debug for EntityTag
[src]

Auto Trait Implementations

impl Send for EntityTag

impl Sync for EntityTag

Blanket Implementations

impl<T> From for T
[src]

impl<T> ToString for T where
    T: Display + ?Sized
[src]

impl<T, U> Into for T where
    U: From<T>, 
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

impl<T, U> TryFrom for T where
    T: From<U>, 
[src]

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

The type returned in the event of a conversion error.

impl<T> Borrow for T where
    T: ?Sized
[src]

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T, U> TryInto for T where
    U: TryFrom<T>, 
[src]

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

The type returned in the event of a conversion error.

impl<T> BorrowMut for T where
    T: ?Sized
[src]

impl<T> Typeable for T where
    T: Any

Get the TypeId of this object.

impl<T> IntoCollection for T

impl<T, I> AsResult for T where
    I: Input, 

impl<Q, K> Equivalent for Q where
    K: Borrow<Q> + ?Sized,
    Q: Eq + ?Sized
[src]