Enum SmfError 

pub enum SmfError {
    InvalidHeader {
        offset: usize,
    },
    UnexpectedEof {
        offset: usize,
    },
    InvalidVlq {
        offset: usize,
    },
    InvalidDivision {
        offset: usize,
        raw: u16,
    },
    LimitExceeded {
        offset: usize,
        kind: SmfLimitKind,
        actual: usize,
        maximum: usize,
    },
    AllocationFailed {
        offset: usize,
        requested: usize,
    },
    MalformedRunningStatus {
        offset: usize,
    },
    UnsupportedStatus {
        offset: usize,
        status: u8,
    },
    InvalidChannelData {
        offset: usize,
    },
    InvalidMetaLength {
        offset: usize,
        type_byte: u8,
        expected: usize,
        actual: usize,
    },
    MissingEndOfTrack {
        offset: usize,
    },
    InvalidSystemEvent {
        offset: usize,
        status: u8,
    },
    FormatTrackMismatch,
    IndependentPatternsCannotMerge,
    TrackCountOutOfRange(usize),
    TpqOutOfRange(u32),
    InexactEventTime,
    NegativeDelta,
    DeltaOutOfRange(i64),
    ChunkTooLarge(usize),
    PayloadTooLarge(usize),
    TimeOverflow {
        offset: usize,
    },
}

Errors raised while reading or writing a Standard MIDI File.

Variants

InvalidHeader

The MThd/MTrk chunk header was malformed.

Fields

offset: usize

Byte offset of the bad header.

UnexpectedEof

The byte stream ended before the structure was complete.

Fields

offset: usize

Byte offset where more input was expected.

InvalidVlq

A variable-length quantity was not terminated within four bytes.

Fields

offset: usize

Byte offset where the VLQ began.

InvalidDivision

The header carried an invalid metrical or SMPTE division.

Fields

offset: usize

Byte offset of the division field.

raw: u16

The raw division value.

LimitExceeded

A configured defensive read limit was exceeded.

Fields

offset: usize

Byte offset of the value or event that crossed the limit.

kind: SmfLimitKind

Resource being bounded.

actual: usize

Requested or observed amount.

maximum: usize

Configured maximum.

AllocationFailed

A bounded allocation failed even though its requested size was within the configured limits.

Fields

offset: usize

Byte offset of the structure that required the allocation.

requested: usize

Number of items requested.

MalformedRunningStatus

A data byte appeared with no running status in effect.

Fields

offset: usize

Byte offset of the offending data byte.

UnsupportedStatus

A status byte that the reader does not handle was encountered.

Fields

offset: usize

Byte offset of the status byte.

status: u8

The unsupported status byte.

InvalidChannelData

A channel message carried an out-of-range data byte.

Fields

offset: usize

Byte offset of the bad data.

InvalidMetaLength

A recognised meta event used a payload length forbidden by SMF.

Fields

offset: usize

Byte offset of the meta type byte.

type_byte: u8

Meta event type.

expected: usize

Required payload length.

actual: usize

Encoded payload length.

MissingEndOfTrack

A track chunk ended without its required end-of-track meta event.

Fields

offset: usize

Byte offset immediately after the track chunk body.

InvalidSystemEvent

A system message used an invalid status, length, or data byte.

Fields

offset: usize

Byte offset of the status or first invalid data byte.

status: u8

System status byte.

FormatTrackMismatch

The header format and the track count are inconsistent (for example, format 0 with more than one track).

IndependentPatternsCannotMerge

Format 2 contains independent patterns and cannot be flattened onto a shared timeline without selecting a track.

TrackCountOutOfRange(usize)

The track count cannot be represented in the SMF header.

TpqOutOfRange(u32)

The ticks-per-quarter value cannot be represented as metrical SMF TPQ.

InexactEventTime

An event time could not be represented exactly at the file resolution.

NegativeDelta

Track events were not monotonic in absolute time, yielding a negative delta.

DeltaOutOfRange(i64)

A track delta cannot be represented as an SMF four-byte VLQ.

ChunkTooLarge(usize)

A track chunk body cannot be represented in the SMF chunk length field.

PayloadTooLarge(usize)

A meta or SysEx payload length cannot be represented as an SMF four-byte VLQ.

TimeOverflow

Absolute tick accumulation overflowed the in-memory event time.

Fields

offset: usize

Byte offset of the delta that overflowed.

Trait Implementations

impl Clone for SmfError

fn clone(&self) -> SmfError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SmfError

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

Formats the value using the given formatter.

impl Display for SmfError

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

Formats the value using the given formatter.

impl Eq for SmfError

impl Error for SmfError

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 PartialEq for SmfError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SmfError