Struct ExtValue 

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

A validated extended value.

Implementations

impl<'a> ExtValue<'a>

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

Parses an extended value.

The charset is UTF-8 or ISO-8859-1 (case-insensitive); the language is empty or letters, digits, and -; the value is attr-char bytes and %XX triples.

Errors

ErrorKind::InvalidCharset (no ', an empty or malformed charset, a malformed language); ErrorKind::UnsupportedCharset; ErrorKind::InvalidPercentEncoding; ErrorKind::InvalidByte, or a control kind, for a byte outside the value grammar.

pub const fn charset(&self) -> Charset

The declared charset.

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

The language tag, possibly empty, as sent.

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

The value-chars, still percent-encoded.

pub fn max_decoded_len(&self) -> usize

An upper bound on the length decode_into writes: exact for UTF-8, doubled for ISO-8859-1.

pub fn decode_into<'b>(&self, out: &'b mut [u8]) -> Result<&'b str, ParseError>

Decodes into out and returns the text: UTF-8 is validated (overlong forms and surrogates refused), ISO-8859-1 is transcoded. A decoded control character (C0, DEL, or C1, such as %0D%0A or %00) is refused: never copy such a value into another header or a log.

Errors

ErrorKind::InvalidUtf8, ErrorKind::ControlInDecoded, ErrorKind::BufferTooSmall. Nothing is written on error.

Trait Implementations

impl<'a> Clone for ExtValue<'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 ExtValue<'a>

impl<'a> Debug for ExtValue<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for ExtValue<'a>

impl<'a> Hash for ExtValue<'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 ExtValue<'a>

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

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for ExtValue<'a>