Struct MediaTypeBuf

pub struct MediaTypeBuf { /* private fields */ }

An owned and immutable media type.

use mediatype::{names::*, values::*, MediaType, MediaTypeBuf, ReadParams};

let text_plain: MediaTypeBuf = "text/plain; charset=UTF-8".parse().unwrap();
assert_eq!(text_plain.get_param(CHARSET).unwrap(), UTF_8);

let mut text_markdown: MediaType = text_plain.to_ref();
text_markdown.subty = MARKDOWN;
assert_eq!(text_markdown.to_string(), "text/markdown; charset=UTF-8");

Implementations

impl MediaTypeBuf

pub fn new(ty: Name<'_>, subty: Name<'_>) -> Self

Constructs a MediaTypeBuf from a top-level type and a subtype.

pub fn from_parts( ty: Name<'_>, subty: Name<'_>, suffix: Option<Name<'_>>, params: &[(Name<'_>, Value<'_>)], ) -> Self

Constructs a MediaTypeBuf with an optional suffix and parameters.

pub fn from_string(s: String) -> Result<Self, MediaTypeError>

Constructs a MediaTypeBuf from String.

Unlike FromStr::from_str, this function takes the ownership of String instead of making a new copy.

Errors

Returns an error if the string fails to be parsed.

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

Returns the top-level type.

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

Returns the subtype.

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

Returns the suffix.

pub fn essence(&self) -> MediaType<'_>

Returns a MediaType without parameters.

let media_type: MediaTypeBuf = "image/svg+xml; charset=UTF-8".parse().unwrap();
assert_eq!(media_type.essence().to_string(), "image/svg+xml");

pub const fn as_str(&self) -> &str

Returns the underlying string.

pub fn canonicalize(&self) -> Self

Returns the canonicalized MediaTypeBuf.

All strings except parameter values will be converted to lowercase.

let media_type: MediaTypeBuf = "IMAGE/SVG+XML;  CHARSET=UTF-8;  ".parse().unwrap();
assert_eq!(
    media_type.canonicalize().to_string(),
    "image/svg+xml; charset=UTF-8"
);

pub fn to_ref(&self) -> MediaType<'_>

Constructs a MediaType from self.

Trait Implementations

impl AsRef<str> for MediaTypeBuf

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for MediaTypeBuf

fn clone(&self) -> MediaTypeBuf

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MediaTypeBuf

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

Formats the value using the given formatter.

impl Display for MediaTypeBuf

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

Formats the value using the given formatter.

impl From<&MediaType<'_>> for MediaTypeBuf

fn from(t: &MediaType<'_>) -> Self

Converts to this type from the input type.

impl<'a> From<&'a MediaTypeBuf> for MediaType<'a>

fn from(t: &'a MediaTypeBuf) -> Self

Converts to this type from the input type.

impl From<MediaType<'_>> for MediaTypeBuf

fn from(t: MediaType<'_>) -> Self

Converts to this type from the input type.

impl FromStr for MediaTypeBuf

type Err = MediaTypeError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

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

impl Hash for MediaTypeBuf

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

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq<&MediaType<'_>> for MediaTypeBuf

fn eq(&self, other: &&MediaType<'_>) -> 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<'a> PartialEq<&MediaTypeBuf> for MediaType<'a>

fn eq(&self, other: &&MediaTypeBuf) -> 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 PartialEq<MediaType<'_>> for &MediaTypeBuf

fn eq(&self, other: &MediaType<'_>) -> 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 PartialEq<MediaType<'_>> for MediaTypeBuf

fn eq(&self, other: &MediaType<'_>) -> 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<'a> PartialEq<MediaTypeBuf> for MediaType<'a>

fn eq(&self, other: &MediaTypeBuf) -> 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 PartialEq for MediaTypeBuf

fn eq(&self, other: &Self) -> 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 ReadParams for MediaTypeBuf

fn params(&self) -> Params<'_>

Returns the parameters.

fn get_param(&self, name: Name<'_>) -> Option<Value<'_>>

Gets the parameter value by its name.

impl Eq for MediaTypeBuf