Enum Family 

#[non_exhaustive]
pub enum Family {
    Image,
    Audio,
    Video,
}

A family of media a file can belong to.

Three members, because three is what a media type’s own first segment offers that a renderer can do anything with. text and application are families too and neither buys a disclosure — there is no preview of an application/octet-stream — so naming them would be a member added for a case nobody has.

It is the answer to “which disclosure”, not a validation rule. Field::accept is what a host filters on.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Image

A still picture.

Audio

Sound.

Video

Moving pictures, with or without sound.

Implementations

impl Family

pub const fn wildcard(self) -> &'static str

The wildcard media type that means the whole family.

image/* and its two siblings, which is what the measured sites write and what a webview puts in an accept attribute. Named here so the three renderers do not each spell the star.

pub fn of_type(media_type: &str) -> Option<Self>

The family a media type’s first segment names, if it is one of these.

Case-insensitive on the segment, because a media type is case-insensitive and half the tree writes them lowercase by habit rather than by rule.

Trait Implementations

impl Clone for Family

fn clone(&self) -> Family

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Family

impl Debug for Family

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

Formats the value using the given formatter.

impl Eq for Family

impl Hash for Family

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 for Family

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Family