Enum HeaderValueTyped 

#[non_exhaustive]
pub enum HeaderValueTyped {
    Raw(String),
    Text(String),
    Addresses(Vec<EmailAddress>),
    GroupedAddresses(Vec<AddressGroup>),
    MessageIds(Vec<String>),
    DateTime(Option<HeaderDateTime>),
    URLs(Vec<String>),
}

A header field value rendered in one of the RFC 8621 parsed forms.

Serde wire format

HeaderValueTyped and HeaderForm use serde’s default representation: externally-tagged for the enum, capitalised Rust variant names. Examples:

{"Addresses": [{"name": "Alice", "address": "alice@example.com"}]}
{"DateTime": null}
{"Raw": "Subject line"}
"Addresses"               // serialized HeaderForm

This is a deliberate choice for in-crate serialization (between services, into databases). It is not the RFC 8621 wire format used over JMAP HTTP/JSON. RFC 8621 §4.1.2 uses property-selector strings such as header:Subject:asAddresses rather than serializing the form name as an enum tag. Callers exposing parsed headers to a JMAP client SHOULD map between this representation and the JMAP wire format at the API boundary; relying on the in-crate serde shape as the wire format will produce a non-conformant JMAP response.

Pre-1.0, this representation is subject to change. From 1.0 onward the in-crate serde format will be a stability surface and will be changed only with a major version bump.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Raw(String)

Result of HeaderForm::Raw: the trimmed UTF-8 string.

Text(String)

Result of HeaderForm::Text: whitespace-unfolded, RFC 2047 decoded, NFC-normalised UTF-8 string.

Addresses(Vec<EmailAddress>)

Result of HeaderForm::Addresses.

GroupedAddresses(Vec<AddressGroup>)

Result of HeaderForm::GroupedAddresses.

MessageIds(Vec<String>)

Result of HeaderForm::MessageIds: bare msg-id strings with no angle brackets.

DateTime(Option<HeaderDateTime>)

Result of HeaderForm::Date, or None if the header value did not parse as a date-time.

URLs(Vec<String>)

Result of HeaderForm::URLs: bare URL strings with no angle brackets.

Trait Implementations

impl Clone for HeaderValueTyped

fn clone(&self) -> HeaderValueTyped

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HeaderValueTyped

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HeaderValueTyped

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for HeaderValueTyped

impl Hash for HeaderValueTyped

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 PartialEq for HeaderValueTyped

fn eq(&self, other: &HeaderValueTyped) -> 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 Serialize for HeaderValueTyped

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for HeaderValueTyped