Struct UploadedFile 

pub struct UploadedFile { /* private fields */ }

A file received in a multipart/form-data request.

Implementations

impl UploadedFile

pub fn field(&self) -> &str

The form field this file arrived under.

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

The client-supplied file name.

Untrusted. A browser sends whatever the client says, which may contain ../, a null byte, or a name designed to collide with something on disk. Use extension and generate your own name when storing; never join this onto a path.

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

The client-supplied MIME type. Also untrusted — sniff the contents if the distinction matters for security.

pub fn bytes(&self) -> &Bytes

The file’s contents.

pub fn size(&self) -> usize

The file’s size in bytes.

pub fn is_empty(&self) -> bool

Whether the part carried no content — a file input left empty submits an empty part rather than nothing at all.

pub fn extension(&self) -> Option<String>

The lowercased extension of the client file name, with no dot, and only when it is alphanumeric — so image.php\0.jpg or x.../y yields None rather than something dangerous to concatenate.

pub fn store(&self, path: impl AsRef<Path>) -> Result<()>

Write the file to path.

Trait Implementations

impl Clone for UploadedFile

fn clone(&self) -> UploadedFile

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UploadedFile

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

Formats the value using the given formatter.