Struct mime_guess::Mime

pub struct Mime<T = Vec<(Attr, Value)>>(pub TopLevel, pub SubLevel, pub T)
 where
    T: AsRef<[(Attr, Value)]>;

Mime, or Media Type. Encapsulates common registers types.

Consider that a traditional mime type contains a "top level type", a "sub level type", and 0-N "parameters". And they're all strings. Strings everywhere. Strings mean typos. Rust has type safety. We should use types!

So, Mime bundles together this data into types so the compiler can catch your typos.

This improves things so you use match without Strings:

use mime::{Mime, TopLevel, SubLevel};

let mime: Mime = "application/json".parse().unwrap();

match mime {
    Mime(TopLevel::Application, SubLevel::Json, _) => println!("matched json!"),
    _ => ()
}

Methods

impl<P> Mime<P> where
    P: AsRef<[(Attr, Value)]>, 

pub fn get_param<A>(&self, attr: A) -> Option<&Value> where
    A: PartialEq<Attr>, 

Trait Implementations

impl<T> Eq for Mime<T> where
    T: Eq + AsRef<[(Attr, Value)]>, 

impl<LHS, RHS> PartialEq<Mime<RHS>> for Mime<LHS> where
    LHS: AsRef<[(Attr, Value)]>,
    RHS: AsRef<[(Attr, Value)]>, 

fn eq(&self, other: &Mime<RHS>) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T> Display for Mime<T> where
    T: AsRef<[(Attr, Value)]>, 

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

Formats the value using the given formatter.

impl<T> Hash for Mime<T> where
    T: AsRef<[(Attr, Value)]> + Hash, 

fn hash<__HT>(&self, state: &mut __HT) where
    __HT: Hasher, 

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl FromStr for Mime<Vec<(Attr, Value)>>

type Err = ()

The associated error which can be returned from parsing.

fn from_str(raw: &str) -> Result<Mime<Vec<(Attr, Value)>>, ()>

Parses a string s to return a value of this type.

impl<T> Ord for Mime<T> where
    T: Ord + AsRef<[(Attr, Value)]>, 

fn cmp(&self, other: &Mime<T>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl<T> Debug for Mime<T> where
    T: AsRef<[(Attr, Value)]> + Debug, 

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

Formats the value using the given formatter.

impl<T> Clone for Mime<T> where
    T: Clone + AsRef<[(Attr, Value)]>, 

fn clone(&self) -> Mime<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> PartialOrd<Mime<T>> for Mime<T> where
    T: PartialOrd<T> + AsRef<[(Attr, Value)]>, 

fn partial_cmp(&self, other: &Mime<T>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Mime<T>) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Mime<T>) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Mime<T>) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Mime<T>) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.