Struct Part 

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

Available on crate feature alloc only.

One part of a buffered multipart body. Its data borrows the body.

Implementations

impl<'a> Part<'a>

pub const fn index(&self) -> u32

The part index, from 0, in body order.

Examples

assert_eq!(mp.parts()[0].index(), 0);

pub fn name(&self) -> &str

The field name, HTML escapes (%0A, %0D, %22) decoded.

Examples

assert_eq!(mp.parts()[0].name(), "a\"b");

pub const fn kind(&self) -> PartKind

Field or file.

Examples

assert_eq!(mp.parts()[0].kind(), form_net::PartKind::File);

pub const fn is_file(&self) -> bool

Whether this is a file part.

Examples

assert!(!mp.parts()[0].is_file());

pub fn filename(&self) -> Option<FileName<'_>>

The client’s file name, for file parts.

Examples

assert_eq!(mp.parts()[0].filename().unwrap().raw(), b"me.png");

pub fn content_type(&self) -> Option<ContentType<'a>>

The declared Content-Type: a hint, never trusted.

Examples

assert!(mp.parts()[0].content_type().unwrap().is("image", "png"));

pub const fn bytes(&self) -> &'a [u8]

The part’s data, borrowed from the body.

Examples

assert_eq!(mp.parts()[0].bytes(), b"hello");

pub fn text(&self) -> Result<&'a str, FormError>

The data as text. Text fields were checked at parse time, so this cannot fail for them; for file parts it checks UTF-8 now.

Errors

Encoding { InvalidUtf8 }.

Examples

assert_eq!(mp.parts()[0].text()?, "hello");

pub const fn len(&self) -> usize

The data length.

Examples

assert_eq!(mp.parts()[0].len(), 5);

pub const fn is_empty(&self) -> bool

Whether the data is empty.

Examples

assert!(mp.parts()[0].is_empty());

Trait Implementations

impl Debug for Part<'_>

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

Formats the value using the given formatter.