Struct ParsedHeader 

#[non_exhaustive]
pub struct ParsedHeader {
    pub name: String,
    pub value: String,
    pub raw_value: Vec<u8>,
}

A decoded RFC 5322 / MIME header field.

For headers whose value mail-parser parses as plain text (Subject, Comments, Content-Description, and any unstructured header), value contains the fully decoded Unicode string (RFC 2047 encoded-words are already resolved).

For all other header types (Address, DateTime, ContentType, Received), value is the raw bytes sliced from the original message and converted with String::from_utf8_lossy. These structured values require their own dedicated parsers — see parse_header_typed.

raw_value always contains the original bytes of the header field value from the wire message (the portion after the : separator). Use raw_value — not value.as_bytes() — when feeding a header into parse_header_typed, because value may have undergone lossy UTF-8 conversion for structured headers.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: String

Header field name (e.g. "From", "Subject").

value: String

Decoded or lossy-converted header field value as a UTF-8 string.

For text headers, this is the fully decoded value (RFC 2047 encoded-words resolved). For structured headers, this is a lossy UTF-8 conversion of the raw bytes — non-UTF-8 bytes are replaced with U+FFFD.

raw_value: Vec<u8>

Raw bytes of the header field value from the original message.

This is the byte sequence after the : separator, preserving the original encoding without lossy UTF-8 conversion. For accurate typed parsing, always use these bytes with parse_header_typed rather than value.as_bytes().

Trait Implementations

impl Clone for ParsedHeader

fn clone(&self) -> ParsedHeader

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParsedHeader

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ParsedHeader

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ParsedHeader

impl PartialEq for ParsedHeader

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

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 ParsedHeader