Enum midly::ErrorKind

pub enum ErrorKind {
    Invalid(&'static str),
    Malformed(&'static str),
    Pedantic(&'static str),
}

The type of error that occurred while parsing.

As a library consumer, detailed errors about what specific part of the MIDI spec was violated are not very useful. For this reason, errors are broadly categorized into 3 classes, and specific error info is provided as a non-normative string literal.

Variants

Invalid(&'static str)

Fatal errors while reading the file. It is likely that the file is not a MIDI file or is severely corrupted.

This error cannot be ignored, as there is not enough data to continue parsing. No information about the file could be rescued.

Malformed(&'static str)

Non-fatal error, but the file is clearly corrupted.

This kind of error is emitted by default, but by enabling the lenient crate feature they can be ignored.

Ignoring these errors can cause whole tracks to be skipped.

Pedantic(&'static str)

Subtle violations to the MIDI spec which occur in the wild, especially in regard to midi meta-messages.

This kind of error is ignored by default, but enabling the strict feature will force the parser to emit them.

Ignoring these errors can cause isolated events to be skipped and reported as MetaMessage::Unknown.

Trait Implementations

impl From<ErrorKind> for Error

fn from(kind: ErrorKind) -> Error

Performs the conversion.

impl Clone for ErrorKind

fn clone(&self) -> ErrorKind

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for ErrorKind

impl Display for ErrorKind

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

Formats the value using the given formatter.

impl Debug for ErrorKind

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

Formats the value using the given formatter.

impl Fail for ErrorKind

fn name(&self) -> Option<&str>

Returns the "name" of the error.

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

Returns a reference to the underlying cause of this failure, if it is an error that wraps other errors.

fn backtrace(&self) -> Option<&Backtrace>

Returns a reference to the Backtrace carried by this failure, if it carries one.

fn context<D>(self, context: D) -> Context<D> where
    D: Display + Send + Sync + 'static, 

Provides context for this failure.

fn compat(self) -> Compat<Self>

Wraps this failure in a compatibility wrapper that implements std::error::Error.