Struct Multipart 

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

Available on crate feature alloc only.

The parts of a buffered multipart body, in body order.

Debug prints names, kinds, and lengths, never data.

Implementations

impl<'a> Multipart<'a>

pub fn parts(&self) -> &[Part<'a>]

Every part, in body order.

Examples

let mp = form_net::parse_multipart(b"multipart/form-data; boundary=X", body)?;
assert_eq!(mp.parts().len(), 1);

pub fn field(&self, name: &str) -> Option<&'a str>

The first text field named name.

Examples

let mp = form_net::parse_multipart(b"multipart/form-data; boundary=X", body)?;
assert_eq!(mp.field("title"), Some("Holiday"));
assert_eq!(mp.field("other"), None);

pub fn field_one(&self, name: &str) -> Result<Option<&'a str>, FormError>

The text field named name, refusing a name given twice.

Errors

Extract { reason: Duplicate, field: None }.

Examples

let mp = form_net::parse_multipart(b"multipart/form-data; boundary=X", body)?;
assert!(mp.field_one("a").is_err());
assert_eq!(mp.field_one("b")?, None);

pub fn fields<'m>(&'m self, name: &'m str) -> impl Iterator<Item = &'a str> + 'm

Every text field named name, in body order.

Examples

let mp = form_net::parse_multipart(b"multipart/form-data; boundary=X", body)?;
assert_eq!(mp.fields("t").collect::<Vec<_>>(), ["a", "b"]);

pub fn file(&self, name: &str) -> Option<&Part<'a>>

The first file part named name.

Examples

let mp = form_net::parse_multipart(b"multipart/form-data; boundary=X", body)?;
assert_eq!(mp.file("f").map(|p| p.bytes()), Some(&b"hi"[..]));

pub fn files<'m>( &'m self, name: &'m str, ) -> impl Iterator<Item = &'m Part<'a>> + 'm

Every file part named name, in body order.

Examples

let mp = form_net::parse_multipart(b"multipart/form-data; boundary=X", body)?;
assert_eq!(mp.files("f").count(), 2);

pub fn len(&self) -> usize

The number of parts.

Examples

let mp = form_net::parse_multipart(b"multipart/form-data; boundary=X", b"--X--")?;
assert_eq!(mp.len(), 0);

pub fn is_empty(&self) -> bool

Whether there are no parts.

Examples

let mp = form_net::parse_multipart(b"multipart/form-data; boundary=X", b"--X--\r\n")?;
assert!(mp.is_empty());

Trait Implementations

impl Debug for Multipart<'_>

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

Formats the value using the given formatter.