Struct ContainerFormat 

pub struct ContainerFormat { /* private fields */ }

The container identification libavformat made for a session.

This is the DEMUXER’s identity, not a filename’s

It is AVInputFormat’s own words — what libavformat concluded from the bytes, having probed them. That is precisely what a content-addressed row wants and what an extension cannot give: the same bytes at movie.mov and movie.mp4 are one content, and this answers identically for both because it never looked at the path.

One demuxer, several words — and name is the list

FFmpeg registers one demuxer per family, so its name is a comma-separated list of the short names that family handles: "mov,mp4,m4a,3gp,3g2,mj2" for the ISOBMFF demuxer, "matroska,webm" for Matroska. name is that string verbatim and names walks it.

The list does not narrow to one word, and this type does not pretend it does. libavformat identified the demuxer; which brand inside that family a file is — an .mp4 against an .m4a — is a question it did not answer and one nothing here can answer for it. A door that returned a single word would have had to pick, and a pick is the guess this whole seat exists to avoid.

Crossing into a typed vocabulary

The words are FFmpeg’s own slugs, which is what makes them crossable: a consumer that wants mediaframe::container::Format tries names against its FromStr and takes what it recognises, deciding for itself what to do when a family offers several. This crate stays out of that decision — the fold belongs to whoever owns the vocabulary, and doing it here would put a second one somewhere a caller cannot see it.

An open vocabulary

Never an enum. A container FFmpeg learns to demux in its next release names itself here with nothing to change on this side, which is the whole reason the identity is carried as text.

Implementations

impl ContainerFormat

pub const fn new(name: SmolStr, long_name: Option<SmolStr>) -> Self

Constructs a ContainerFormat from a demuxer’s short-name list and its optional description.

Public so a consumer can build the value in a test or a fake; a session builds its own from AVFormatContext.iformat.

pub fn name(&self) -> &str

The demuxer’s short-name list, verbatim — "mov,mp4,m4a,3gp,3g2,mj2".

See names for the words in it.

pub fn long_name(&self) -> Option<&str>

The demuxer’s human description — "QuickTime / MOV" — or None where the table carries none.

FFmpeg’s prose, for display. It is not stable across releases and nothing should key on it.

pub fn names(&self) -> impl Iterator<Item = &str>

The short names in name, in the order the demuxer lists them.

Every FFmpeg name is a non-empty word or a comma list of them, so this yields at least one item for any format a session opened with.

Trait Implementations

impl Clone for ContainerFormat

fn clone(&self) -> ContainerFormat

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContainerFormat

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

Formats the value using the given formatter.

impl Eq for ContainerFormat

impl Hash for ContainerFormat

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 ContainerFormat

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ContainerFormat