Struct ContentDisposition 

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

A validated Content-Disposition value.

Examples

let cd = parse_net::parse_content_disposition(b"attachment; filename=report.pdf")?;
assert_eq!(cd.kind(), parse_net::DispositionType::Attachment);
assert!(cd.filename_plain().is_some_and(|f| f.eq_bytes(b"report.pdf")));

Implementations

impl<'a> ContentDisposition<'a>

pub const fn kind(&self) -> DispositionType<'a>

The disposition type.

Examples

use parse_net::{parse_content_disposition, DispositionType};

let cd = parse_content_disposition(b"Form-Data; name=field")?;
assert_eq!(cd.kind(), DispositionType::FormData);

pub const fn params(&self) -> Params<'a>

Every parameter.

Examples

let cd = parse_net::parse_content_disposition(b"inline; size=120; x=\"y\"")?;
assert_eq!(cd.params().len(), 2);
assert!(cd.params().get("size").is_some_and(|v| v.eq_bytes(b"120")));

pub fn name(&self) -> Option<Word<'a>>

The name parameter (the field name of a form-data part).

Examples

use parse_net::parse_content_disposition;

let part = parse_content_disposition(b"form-data; name=\"comment\"")?;
assert!(part.name().is_some_and(|n| n.eq_bytes(b"comment")));
assert!(parse_content_disposition(b"attachment")?.name().is_none());

pub fn filename(&self) -> Option<Filename<'a>>

The file name: filename* when present, else filename (RFC 6266 section 4.3).

Examples

let cd = parse_net::parse_content_disposition(b"attachment; filename=plain.txt; filename*=UTF-8''ext.txt")?;
let mut buf = [0u8; 16];
assert_eq!(cd.filename().expect("present").decode_into(&mut buf)?, "ext.txt");

pub fn filename_plain(&self) -> Option<Word<'a>>

The filename parameter as sent.

Examples

let cd = parse_net::parse_content_disposition(b"attachment; filename=plain.txt; filename*=UTF-8''ext.txt")?;
assert!(cd.filename_plain().is_some_and(|f| f.eq_bytes(b"plain.txt")));

pub fn filename_ext(&self) -> Option<ExtValue<'a>>

The filename* parameter, decoded as an RFC 8187 value.

Examples

let cd = parse_net::parse_content_disposition(b"attachment; filename=plain.txt; filename*=UTF-8''ext.txt")?;
let ext = cd.filename_ext().expect("present");
assert_eq!((ext.charset(), ext.encoded()), (parse_net::Charset::Utf8, &b"ext.txt"[..]));

Trait Implementations

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

impl<'a> Debug for ContentDisposition<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for ContentDisposition<'a>

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

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

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for ContentDisposition<'a>