1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
use alloc::fmt;
use core::error;
/// Returned when [`MidiMsg::from_midi`](crate::MidiMsg::from_midi) and similar where not successful.
#[derive(Debug, PartialEq, Clone)]
pub enum ParseError {
/// The given input ended before a `MidiMsg` could be fully formed.
UnexpectedEnd,
/// Received a non-status byte with no prior channel messages.
ContextlessRunningStatus,
/// Reached end without an End of System Exclusive flag.
NoEndOfSystemExclusiveFlag,
/// Encountered an unexpected End of System Exclusive flag.
UnexpectedEndOfSystemExclusiveFlag,
/// Received a system exclusive message but the crate
/// was built without the sysex feature.
SystemExclusiveDisabled,
/// Received a meta event message but the crate
/// was built without the file feature.
FileDisabled,
/// The series of bytes was otherwise invalid.
Invalid(&'static str),
/// Attempted to use a not yet implemented feature.
NotImplemented(&'static str),
/// A byte exceeded 7 bits.
ByteOverflow,
/// A variable length quanity exceeded 4 bytes.
VlqOverflow,
/// Encountered an undefined system common message
UndefinedSystemCommonMessage(u8),
/// Encountered an undefined system real time message
UndefinedSystemRealTimeMessage(u8),
/// Encountered an undefined system exclusive message
UndefinedSystemExclusiveMessage(Option<u8>),
}
impl error::Error for ParseError {}
impl fmt::Display for ParseError {
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
write!(f, "Error parsing MIDI input: ")?;
match self {
Self::UnexpectedEnd => {
write!(f, "The input ended before a MidiMsg could be fully formed")
}
Self::ContextlessRunningStatus => write!(
f,
"Received a non-status byte with no prior channel messages"
),
Self::NoEndOfSystemExclusiveFlag => {
write!(
f,
"Tried to read a SystemExclusiveMsg, but reached the end without an End of System Exclusive flag"
)
}
Self::UnexpectedEndOfSystemExclusiveFlag => {
write!(f, "Encountered an unexpected End of System Exclusive flag")
}
Self::SystemExclusiveDisabled => {
write!(
f,
"Received a system exclusive message but the crate was built without the sysex feature"
)
}
Self::FileDisabled => {
write!(
f,
"Received a meta event message but the crate was built without the file feature"
)
}
Self::NotImplemented(msg) => {
write!(f, "{} is not yet implemented", msg)
}
Self::Invalid(s) => write!(f, "{}", s),
Self::ByteOverflow => write!(f, "A byte exceeded 7 bits"),
Self::VlqOverflow => write!(f, "A variable-length quantity exceeded 4 bytes"),
Self::UndefinedSystemCommonMessage(byte) => write!(
f,
"Encountered undefined system common message {:#04x}",
byte
),
Self::UndefinedSystemRealTimeMessage(byte) => write!(
f,
"Encountered undefined system real time message {:#04x}",
byte
),
Self::UndefinedSystemExclusiveMessage(byte) => {
if let Some(byte) = byte {
write!(
f,
"Encountered undefined system exclusive message {:#04x}",
byte
)
} else {
write!(
f,
"Encountered undefined system exclusive message {:?}",
byte
)
}
}
}
}
}