Struct MediaTypeGuess 

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

A guess of the media type(s) of a file extension or path, as one or more MediaType values.

Ordering

A given file format may have one or more applicable media types. The first one is the one declared by the most recent IETF RFC or the one that explicitly supersedes all others; the ordering of the additional ones is arbitrary.

Values are not stable

The exact media types returned by a guess are not part of the crate’s stable API and may be updated in patch releases to be as accurate as possible.

Implementations

impl MediaTypeGuess

pub fn from_ext(ext: &str) -> MediaTypeGuess

Guess the media type(s) of a file with the given extension.

The search is case-insensitive. If ext is empty or has no known media type, an empty guess is returned.

Examples

assert_eq!(media_type::from_ext("png").first(), Some(media_type::IMAGE_PNG));
assert!(media_type::from_ext("").is_empty());

pub fn from_path<P: AsRef<Path>>(path: P) -> MediaTypeGuess

Guess the media type(s) of path by its extension (as defined by Path::extension). No disk access is performed.

If path has no extension, its extension is not valid UTF-8, or it has no known media type, an empty guess is returned. The search is case-insensitive.

Note

There is no guarantee that the contents of the file match the media type associated with its extension. Take care when making assumptions based on the return value of this function.

pub fn is_empty(&self) -> bool

Returns true if the guess did not find any media type for the given extension or path.

pub fn count(&self) -> usize

Return the number of media types in this guess.

pub fn first(&self) -> Option<MediaType>

Get the first guessed MediaType, if any.

pub fn first_raw(&self) -> Option<&'static str>

Get the first guessed media type as a raw string, if any.

pub fn first_or_octet_stream(&self) -> MediaType

Get the first guessed MediaType, or APPLICATION_OCTET_STREAM if the guess is empty.

pub fn first_or_text_plain(&self) -> MediaType

Get the first guessed MediaType, or TEXT_PLAIN if the guess is empty.

pub fn first_or(&self, default: MediaType) -> MediaType

Get the first guessed MediaType, or the given default if the guess is empty.

pub fn first_or_else<F>(&self, default: F) -> MediaType

where F: FnOnce() -> MediaType,

Get the first guessed MediaType, or the result of default if the guess is empty.

pub fn iter(&self) -> Iter

Return an iterator over the MediaType values contained in this guess.

pub fn iter_raw(&self) -> IterRaw

Return an iterator over the raw media type strings contained in this guess.

Trait Implementations

impl Clone for MediaTypeGuess

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for MediaTypeGuess

impl Debug for MediaTypeGuess

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

Formats the value using the given formatter.

impl Eq for MediaTypeGuess

impl IntoIterator for MediaTypeGuess

Available on crate feature alloc only.

type Item = MediaType

The type of the elements being iterated over.

type IntoIter = Iter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a> IntoIterator for &'a MediaTypeGuess

Available on crate feature alloc only.

type Item = MediaType

The type of the elements being iterated over.

type IntoIter = Iter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for MediaTypeGuess

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for MediaTypeGuess