Struct Continuation 

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

The sections of an RFC 2231 continued value, validated at parse.

Examples

use parse_net::{mail::{self, MimeValue}, Limits};

let (p, _) = mail::parse_mime_params(b"; url*0=\"http://a.example/\"; url*1=\"b\"", &Limits::DEFAULT)?;
let Some(MimeValue::Continued(c)) = p.get("url") else { unreachable!() };
let mut buf = [0u8; 32];
assert_eq!(c.decode_into(&mut buf)?, "http://a.example/b");

Implementations

impl Continuation<'_>

pub fn sections(&self) -> usize

The number of sections.

Examples

use parse_net::{mail::{self, MimeValue}, Limits};

let (p, _) = mail::parse_mime_params(b"; n*0=a; n*1=b; n*2=c", &Limits::DEFAULT)?;
let Some(MimeValue::Continued(c)) = p.get("n") else { unreachable!() };
assert_eq!(c.sections(), 3);

pub fn max_decoded_len(&self) -> usize

An upper bound on the decoded length (twice the raw length, for ISO-8859-1 transcoded to UTF-8).

Examples

use parse_net::{mail::{self, MimeValue}, Limits};

let (p, _) = mail::parse_mime_params(b"; t*0=abc; t*1=de", &Limits::DEFAULT)?;
let Some(MimeValue::Continued(c)) = p.get("t") else { unreachable!() };
assert_eq!(c.max_decoded_len(), 10);
let mut buf = [0u8; 10];
assert_eq!(c.decode_into(&mut buf)?, "abcde");

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

Decodes the sections in order into out: %XX in extended sections, the charset of section 0 (UTF-8 or ISO-8859-1, transcoded).

Errors

ErrorKind::BufferTooSmall; nothing is written on error.

Examples

use parse_net::{mail::{self, MimeValue}, Limits};

let (p, _) = mail::parse_mime_params(b"; title*0*=iso-8859-1'en'%A3; title*1=\" rates\"", &Limits::DEFAULT)?;
let Some(MimeValue::Continued(c)) = p.get("title") else { unreachable!() };
let mut buf = [0u8; 16];
assert_eq!((c.sections(), c.decode_into(&mut buf)?), (2, "\u{a3} rates"));

Trait Implementations

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

impl<'a> Debug for Continuation<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for Continuation<'a>

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

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

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for Continuation<'a>