Struct EntityTag 

pub struct EntityTag<'t> {
    pub weak: bool,
    /* private fields */
}

An entity tag, defined in RFC7232.

Fields

weak: bool

Whether to have a weakness indicator.

Implementations

impl<'t> EntityTag<'t>

pub const HEADER_NAME: &'static str = "ETag"

ETag

impl<'t> EntityTag<'t>

pub const unsafe fn new_unchecked(weak: bool, tag: Cow<'t, str>) -> Self

Construct a new EntityTag without checking.

Safety

The caller must ensure tag is a valid unquoted entity-tag value, because this function skips all validation.

pub const fn get_tag_cow(&self) -> &Cow<'t, str>

Get the tag. The double quotes are not included.

impl<'t> EntityTag<'t>

pub unsafe fn with_string_unchecked<S: Into<String>>( weak: bool, tag: S, ) -> EntityTag<'static>

Construct a new EntityTag without checking.

Safety

The caller must ensure tag is a valid unquoted entity-tag value, because this function skips all validation.

pub unsafe fn with_str_unchecked<S: ?Sized + AsRef<str>>( weak: bool, tag: &'t S, ) -> Self

Construct a new EntityTag without checking.

Safety

The caller must ensure tag is a valid unquoted entity-tag value, because this function skips all validation.

impl<'t> EntityTag<'t>

pub fn with_string<S: AsRef<str> + Into<String>>( weak: bool, tag: S, ) -> Result<EntityTag<'static>, EntityTagError>

Construct a new EntityTag from an opaque tag, with or without surrounding double quotes.

pub fn with_str<S: ?Sized + AsRef<str>>( weak: bool, tag: &'t S, ) -> Result<Self, EntityTagError>

Construct a new EntityTag from an opaque tag, with or without surrounding double quotes.

impl<'t> EntityTag<'t>

pub fn from_string<S: AsRef<str> + Into<String>>( etag: S, ) -> Result<EntityTag<'static>, EntityTagError>

Parse and construct a new EntityTag from a full ETag header value.

pub fn from_str<S: ?Sized + AsRef<str>>( etag: &'t S, ) -> Result<Self, EntityTagError>

Parse and construct a new EntityTag from a full ETag header value.

impl<'t> EntityTag<'t>

pub fn get_tag(&self) -> &str

Get the tag. The double quotes are not included.

pub fn into_tag(self) -> Cow<'t, str>

Into the tag. The double quotes are not included.

pub fn into_owned(self) -> EntityTag<'static>

Extracts the owned data.

impl<'t> EntityTag<'t>

pub fn strong_eq(&self, other: &EntityTag<'_>) -> bool

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

pub fn weak_eq(&self, other: &EntityTag<'_>) -> bool

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”.

pub fn strong_ne(&self, other: &EntityTag<'_>) -> bool

The inverse of strong_eq.

pub fn weak_ne(&self, other: &EntityTag<'_>) -> bool

The inverse of weak_eq.

Trait Implementations

impl<'t> Clone for EntityTag<'t>

fn clone(&self) -> EntityTag<'t>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'t> Debug for EntityTag<'t>

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

Formats the value using the given formatter.

impl<'t> Display for EntityTag<'t>

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

Formats the value using the given formatter.

impl<'t> Eq for EntityTag<'t>

impl FromStr for EntityTag<'static>

type Err = EntityTagError

The associated error which can be returned from parsing.

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

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

impl<'t> Hash for EntityTag<'t>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'t> PartialEq for EntityTag<'t>

fn eq(&self, other: &EntityTag<'t>) -> 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<'t> StructuralPartialEq for EntityTag<'t>