Struct EntityTag 

pub struct EntityTag<'a> { /* private fields */ }

An entity tag: a weak flag and the opaque bytes between the quotes.

Examples

use parse_net::EntityTag;

let t = EntityTag::parse(b"W/\"abc\"")?;
assert!(t.is_weak());
assert_eq!(t.opaque(), b"abc");
assert!(t.weak_eq(&EntityTag::strong(b"abc")?));
assert!(!t.strong_eq(&EntityTag::strong(b"abc")?));

Implementations

impl<'a> EntityTag<'a>

pub fn parse(value: &'a [u8]) -> Result<Self, ParseError>

Parses [ "W/" ] DQUOTE *etagc DQUOTE (OWS around it stripped). W/ is case-sensitive.

Errors

ErrorKind::InvalidEntityTag (a lowercase w/, no quotes, a byte outside etagc, W/ "a"); ErrorKind::TrailingData.

pub const fn strong(opaque: &'a [u8]) -> Result<Self, ParseError>

A strong tag with the given opaque bytes.

Errors

ErrorKind::InvalidEntityTag at the first byte that is not an etagc.

pub const fn weak(opaque: &'a [u8]) -> Result<Self, ParseError>

A weak tag with the given opaque bytes.

Errors

As strong.

pub const fn is_weak(&self) -> bool

Whether the tag is weak (W/).

pub const fn opaque(&self) -> &'a [u8]

The opaque bytes, without the quotes.

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

Strong comparison (RFC 9110 section 8.8.3.2): both strong and equal.

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

Weak comparison: equal opaque bytes, either may be weak.

pub fn write_to(&self, out: &mut impl Sink) -> Result<(), WriteError>

Writes W/"..." or "...".

Errors

WriteError::Full; nothing is written when the sink reports its room.

Examples

use parse_net::{EntityTag, SliceSink};

let mut buf = [0u8; 16];
let mut out = SliceSink::new(&mut buf);
EntityTag::weak(b"v1")?.write_to(&mut out).expect("room");
assert_eq!(out.written(), b"W/\"v1\"");

Trait Implementations

impl<'a> Clone for EntityTag<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for EntityTag<'a>

impl<'a> Debug for EntityTag<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for EntityTag<'a>

impl<'a> Hash for EntityTag<'a>

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<'a> PartialEq for EntityTag<'a>

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

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for EntityTag<'a>