Enum Error 

#[non_exhaustive]
pub enum Error {
    Io(Error),
    Truncated {
        at: u64,
        needed: u64,
    },
    BoxSizeTooSmall {
        kind: FourCc,
        size: u64,
        at: u64,
    },
    BoxExceedsFile {
        kind: FourCc,
        at: u64,
        declared_end: u64,
        file_len: u64,
    },
    ChildExceedsParent {
        parent: FourCc,
        child: FourCc,
        at: u64,
    },
    ZeroSizeNested {
        kind: FourCc,
        at: u64,
    },
    NestingTooDeep {
        depth: u8,
        at: u64,
    },
    MissingBox {
        kind: FourCc,
        parent: Option<FourCc>,
    },
    DuplicateBox {
        kind: FourCc,
        parent: FourCc,
    },
    Malformed {
        kind: FourCc,
        reason: &'static str,
    },
    InvalidSampleTable {
        track: TrackId,
        reason: &'static str,
    },
    InvalidTimescale {
        track: Option<TrackId>,
    },
    SampleOutOfFile {
        track: TrackId,
        index: u32,
        offset: u64,
        size: u32,
        file_len: u64,
    },
    LimitExceeded {
        limit: &'static str,
        value: u64,
        max: u64,
    },
    Unsupported(&'static str),
    NoSuchTrack(TrackId),
    NoSuchSample {
        track: TrackId,
        index: u32,
    },
    Atom(Error),
    WriterState(&'static str),
}

Errors produced by parsing, sample reads, and writing.

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.

Io(Error)

An input or output operation failed.

Truncated

A header or fixed field ended early.

Fields

at: u64

Absolute byte offset.

needed: u64

Required byte count.

BoxSizeTooSmall

A box size is smaller than its header.

Fields

kind: FourCc

Box code.

size: u64

Declared size.

at: u64

Absolute box offset.

BoxExceedsFile

A top-level box extends beyond the stream.

Fields

kind: FourCc

Box code.

at: u64

Absolute box offset.

declared_end: u64

Declared box end.

file_len: u64

Stream length.

ChildExceedsParent

A child box extends beyond its parent.

Fields

parent: FourCc

Parent box code.

child: FourCc

Child box code.

at: u64

Absolute child offset.

ZeroSizeNested

A nested box uses a zero size.

Fields

kind: FourCc

Box code.

at: u64

Absolute box offset.

NestingTooDeep

Structural nesting exceeds the configured limit.

Fields

depth: u8

Observed depth.

at: u64

Absolute box offset.

MissingBox

A required box is missing.

Fields

kind: FourCc

Missing box code.

parent: Option<FourCc>

Expected parent.

DuplicateBox

A box that must be unique appears more than once.

Fields

kind: FourCc

Repeated box code.

parent: FourCc

Enclosing box code.

Malformed

A known box has invalid fields.

Fields

kind: FourCc

Box code.

reason: &'static str

Stable failure description.

InvalidSampleTable

A sample table is inconsistent.

Fields

track: TrackId

Affected track.

reason: &'static str

Stable failure description.

InvalidTimescale

A movie or media timescale is zero.

Fields

track: Option<TrackId>

Affected track, or None for the movie.

SampleOutOfFile

A sample points beyond the stream.

Fields

track: TrackId

Affected track.

index: u32

Zero-based sample index.

offset: u64

Absolute sample offset.

size: u32

Sample size.

file_len: u64

Stream length.

LimitExceeded

A configured resource limit was exceeded.

Fields

limit: &'static str

Limit name.

value: u64

Observed value.

max: u64

Configured maximum.

Unsupported(&'static str)

The file uses an unsupported feature.

NoSuchTrack(TrackId)

No track has the requested identifier.

NoSuchSample

The requested sample index is absent.

Fields

track: TrackId

Requested track.

index: u32

Zero-based sample index.

Atom(Error)

The box-layer dependency rejected data.

WriterState(&'static str)

A writer method was called in an invalid state.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for Error

fn from(value: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(value: Error) -> Self

Converts to this type from the input type.