Enum DispositionParam

pub enum DispositionParam {
    Name(String),
    Filename(String),
    FilenameExt(ExtendedValue),
    Unknown(String, String),
    UnknownExt(String, ExtendedValue),
}

Parameter in ContentDisposition.

Examples

use requiem_http::http::header::DispositionParam;

let param = DispositionParam::Filename(String::from("sample.txt"));
assert!(param.is_filename());
assert_eq!(param.as_filename().unwrap(), "sample.txt");

Variants

Name(String)

For DispositionType::FormData (i.e. multipart/form-data), the name of an field from the form.

Filename(String)

A plain file name.

It is not supposed to contain any non-ASCII characters when used in a Content-Disposition HTTP response header, where FilenameExt with charset UTF-8 may be used instead in case there are Unicode characters in file names.

FilenameExt(ExtendedValue)

An extended file name. It must not exist for ContentType::Formdata according to RFC7578 Section 4.2.

Unknown(String, String)

An unrecognized regular parameter as defined in RFC5987 as reg-parameter, in RFC6266 as token “=” value. Recipients should ignore unrecognizable parameters.

UnknownExt(String, ExtendedValue)

An unrecognized extended paramater as defined in RFC5987 as ext-parameter, in RFC6266 as ext-token “=” ext-value. The single trailling asterisk is not included. Recipients should ignore unrecognizable parameters.

Implementations

impl DispositionParam

pub fn is_name(&self) -> bool

Returns true if the paramater is Name.

pub fn is_filename(&self) -> bool

Returns true if the paramater is Filename.

pub fn is_filename_ext(&self) -> bool

Returns true if the paramater is FilenameExt.

pub fn is_unknown<T: AsRef<str>>(&self, name: T) -> bool

Returns true if the paramater is Unknown and the name matches.

pub fn is_unknown_ext<T: AsRef<str>>(&self, name: T) -> bool

Returns true if the paramater is UnknownExt and the name matches.

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

Returns the name if applicable.

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

Returns the filename if applicable.

pub fn as_filename_ext(&self) -> Option<&ExtendedValue>

Returns the filename* if applicable.

pub fn as_unknown<T: AsRef<str>>(&self, name: T) -> Option<&str>

Returns the value of the unrecognized regular parameter if it is Unknown and the name matches.

pub fn as_unknown_ext<T: AsRef<str>>(&self, name: T) -> Option<&ExtendedValue>

Returns the value of the unrecognized extended parameter if it is Unknown and the name matches.

Trait Implementations

impl Clone for DispositionParam

fn clone(&self) -> DispositionParam

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DispositionParam

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

Formats the value using the given formatter.

impl Display for DispositionParam

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

Formats the value using the given formatter.

impl PartialEq for DispositionParam

fn eq(&self, other: &DispositionParam) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for DispositionParam