Struct FieldHeaders

pub struct FieldHeaders {
    pub name: String,
    pub filename: Option<String>,
    pub content_type: Option<Mime>,
}

The headers of a Field, including the name, filename, and Content-Type, if provided.

Note: Untrustworthy

These values are provided directly by the client, and as such, should be considered untrustworthy and potentially dangerous. Avoid any unsanitized usage on the filesystem or in a shell or database, or performing unsafe operations with the assumption of a certain file type. Sanitizing/verifying these values is (currently) beyond the scope of this crate.

Fields

name: String

The name of the field as provided by the client.

Special Value: _charset_

If the client intended a different character set than UTF-8 for its text values, it may provide the name of the charset as a text field (ASCII-encoded) with the name _charset_. See IETF RFC 7578, Section 4.6 for more.

Alternately, the charset can be provided for an individual field as a charset parameter to its Content-Type header; see the charset() method for a convenient wrapper.

filename: Option<String>

The name of the file as it was on the client. If not provided, it may still have been a file field.

content_type: Option<Mime>

The Content-Type of this field, as provided by the client. If None, then the field is probably text, but this is not guaranteed.

Implementations

impl FieldHeaders

pub fn is_text(&self) -> bool

true if content_type is None or text/* (such as text/plain).

Note: this does not guarantee that the field data is compatible with FieldData::read_text(); supporting more encodings than ASCII/UTF-8 is (currently) beyond the scope of this crate.

pub fn charset(&self) -> Option<Name<'_>>

The character set of this field, if provided.

Trait Implementations

impl Clone for FieldHeaders

fn clone(&self) -> FieldHeaders

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FieldHeaders

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

Formats the value using the given formatter.

impl Default for FieldHeaders

fn default() -> FieldHeaders

Returns the “default value” for a type.