Struct MediaType 

pub struct MediaType<'a> { /* private fields */ }

A validated media type.

Examples

let ld = parse_net::parse_media_type(b"application/ld+json")?;
assert_eq!(ld.suffix(), Some(&b"json"[..]));
assert!(ld.is_json());

Implementations

impl<'a> MediaType<'a>

pub const fn type_(&self) -> &'a [u8]

The type, as sent.

pub const fn subtype(&self) -> &'a [u8]

The subtype, as sent.

pub fn suffix(&self) -> Option<&'a [u8]>

The structured syntax suffix: the part of the subtype after its last + (json of ld+json), when there is one.

pub fn essence_is(&self, essence: &str) -> bool

Whether type/subtype equals essence, ignoring ASCII case.

pub fn is(&self, type_: &str, subtype: &str) -> bool

Whether the type and subtype equal type_ and subtype, ignoring ASCII case.

pub const fn params(&self) -> Params<'a>

The parameters.

pub fn param(&self, name: &str) -> Option<Word<'a>>

The value of the parameter name (ASCII case-insensitive).

pub fn charset(&self) -> Option<Word<'a>>

The charset parameter. Compare it case-insensitively.

pub fn boundary(&self) -> Result<Option<Boundary<'a>>, ParseError>

The boundary parameter, validated by RFC 2046 section 5.1.1: 1 to 70 bchars, the last not a space. Ok(None) when absent.

Errors

ErrorKind::InvalidBoundary, with the offset inside the boundary value.

pub fn is_json(&self) -> bool

Whether this is application/json or has the +json suffix.

pub fn is_form_urlencoded(&self) -> bool

Whether this is application/x-www-form-urlencoded.

pub fn is_multipart_form_data(&self) -> bool

Whether this is multipart/form-data.

pub fn write_canonical(&self, out: &mut impl Sink) -> Result<(), WriteError>

Writes the media type with the type, subtype, and parameter names in lowercase and the values as sent, separated by ; .

Errors

WriteError::Full; nothing is written when the sink reports its room.

Examples

use parse_net::{parse_media_type, SliceSink};

let mt = parse_media_type(b"Text/HTML;Charset=\"UTF-8\"")?;
let mut buf = [0u8; 64];
let mut out = SliceSink::new(&mut buf);
mt.write_canonical(&mut out).expect("room");
assert_eq!(out.written(), b"text/html; charset=\"UTF-8\"");

Trait Implementations

impl<'a> Clone for MediaType<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for MediaType<'a>

impl<'a> Debug for MediaType<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for MediaType<'a>

impl<'a> Hash for MediaType<'a>

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<'a> PartialEq for MediaType<'a>

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

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for MediaType<'a>