Struct Field 

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

One part of a streamed multipart/form-data body.

Borrowed from the parser, so only one field exists at a time: the body is a single stream and the parts are in it in order.

Implementations

impl Field<'_>

pub fn name(&self) -> &str

The name from Content-Disposition.

pub fn filename(&self) -> Option<&str>

The filename, when the part is a file upload.

pub fn content_type(&self) -> Option<&str>

The part’s own Content-Type, if it declared one.

pub async fn chunk(&mut self) -> Result<Option<Bytes>>

The next slice of this field’s content, or None at its end.

Chunk boundaries follow whatever arrived from the network and carry no meaning: a field’s content is the concatenation of its chunks.

Errors

If the body is malformed or ends inside the part.

pub async fn bytes(&mut self) -> Result<Bytes>

Collect the whole field into memory.

Errors

413 past MultipartStream::max_field_bytes, or whatever chunk would have returned. The limit is checked as the field is read, so an oversized field is refused partway rather than after it has all been buffered.

pub async fn text(&mut self) -> Result<String>

Collect the whole field as UTF-8 text.

Errors

As bytes, plus 400 if the content is not UTF-8.

Trait Implementations

impl Debug for Field<'_>

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

Formats the value using the given formatter.