pub fn parse_headers_only(raw: &[u8]) -> Result<ParsedEmail, Error>Expand description
Parses only the headers of a raw email message, skipping body/MIME processing.
This is faster than parse_email when only metadata is needed (e.g.,
building a message list). Body-related fields (body_text, body_html,
attachments) are always empty/None.
§References
- RFC 5322 Sections 2.1–2.2 (header/body separation, header folding)
- RFC 5322 Sections 3.3–3.6 (date-time, address, field definitions)
- RFC 2047 Sections 3–4 (encoded-word decoding in headers)
- RFC 6532 Section 3 (internationalized header fields)