Struct ContentType

pub struct ContentType(/* private fields */);

Content-Type header, defined in RFC7231

The Content-Type header field indicates the media type of the associated representation: either the representation enclosed in the message payload or the selected representation, as determined by the message semantics. The indicated media type defines both the data format and how that data is intended to be processed by a recipient, within the scope of the received message semantics, after any content codings indicated by Content-Encoding are decoded.

Although the mime crate allows the mime options to be any slice, this crate forces the use of Vec. This is to make sure the same header can’t have more than 1 type. If this is an issue, it’s possible to implement Header on a custom struct.

ABNF

Content-Type = media-type

Example values

• text/html; charset=utf-8
• application/json

Examples

use headers::ContentType;

let ct = ContentType::json();

Implementations

impl ContentType

pub fn json() -> ContentType

A constructor to easily create a Content-Type: application/json header.

pub fn text() -> ContentType

A constructor to easily create a Content-Type: text/plain header.

pub fn text_utf8() -> ContentType

A constructor to easily create a Content-Type: text/plain; charset=utf-8 header.

pub fn html() -> ContentType

A constructor to easily create a Content-Type: text/html header.

pub fn xml() -> ContentType

A constructor to easily create a Content-Type: text/xml header.

pub fn form_url_encoded() -> ContentType

A constructor to easily create a Content-Type: application/www-form-url-encoded header.

pub fn jpeg() -> ContentType

A constructor to easily create a Content-Type: image/jpeg header.

pub fn png() -> ContentType

A constructor to easily create a Content-Type: image/png header.

pub fn octet_stream() -> ContentType

A constructor to easily create a Content-Type: application/octet-stream header.

Trait Implementations

impl Clone for ContentType

fn clone(&self) -> ContentType

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ContentType

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

Formats the value using the given formatter.

impl Display for ContentType

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

Formats the value using the given formatter.

impl From<ContentType> for Mime

fn from(ct: ContentType) -> Mime

Converts to this type from the input type.

impl From<Mime> for ContentType

fn from(m: Mime) -> ContentType

Converts to this type from the input type.

impl FromStr for ContentType

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<ContentType, <ContentType as FromStr>::Err>

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

impl Header for ContentType

fn name() -> &'static HeaderName

The name of this header.

fn decode<'i, I>(values: &mut I) -> Result<ContentType, Error>

where I: Iterator<Item = &'i HeaderValue>,

Decode this type from an iterator of HeaderValues.

fn encode<E>(&self, values: &mut E)

where E: Extend<HeaderValue>,

Encode this type to a HeaderMap.

impl PartialEq for ContentType

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