Struct entity_tag::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.

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.

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

Construct a new EntityTag without checking.

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.

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

Construct a new EntityTag.

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

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

Parse and construct a new EntityTag from a str.

pub fn from_data<S: ?Sized + AsRef<[u8]>>(data: &S) -> EntityTag<'static>

Construct a strong EntityTag.

pub fn from_file_meta(metadata: &Metadata) -> EntityTag<'static>

Construct a weak EntityTag.

impl<'t> EntityTag<'t>

pub fn get_tag(&'t self) -> &'t 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 copy 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> PartialEq<EntityTag<'t>> for EntityTag<'t>

fn eq(&self, other: &EntityTag<'t>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

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

impl<'t> StructuralEq for EntityTag<'t>

impl<'t> StructuralPartialEq for EntityTag<'t>