#[non_exhaustive]pub enum ColdError {
Io(Error),
Seg(SegError),
Reopen {
file: String,
source: SegError,
},
CorruptKey,
CorruptPayload,
}Expand description
Why sealing entries into a cold segment, or reading them back, failed. The spill is derived data: the caller reports the error and the entries stay rebuildable from the rows.
use kevy_window::ColdError;
assert_eq!(ColdError::CorruptKey.to_string(), "corrupt cold key");Variants (Non-exhaustive)§
This enum is marked as 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)
The segment directory could not be created.
let mut w = kevy_window::WindowRt::new(WindowSpec::new("ts", 100, 50), WindowShape::PlainI64);
let mut seg = Segment::new();
seg.apply(b"r:10", None, Some(IndexValue::I64(10)));
seg.apply(b"r:300", None, Some(IndexValue::I64(300)));
let file = dir.path().join("plain-file");
std::fs::write(&file, b"")?;
// a directory cannot be created under a regular file
let e = w.slide(b"t.ts", &mut seg, &file.join("segs")).unwrap_err();
assert!(matches!(e, kevy_window::ColdError::Io(_)));
assert_eq!(seg.stats().entries, 2); // the tree is untouchedSeg(SegError)
A segment or the manifest refused.
let mut w = kevy_window::WindowRt::new(WindowSpec::new("ts", 100, 50), WindowShape::PlainI64);
let mut seg = Segment::new();
seg.apply(b"r:10", None, Some(IndexValue::I64(10)));
seg.apply(b"r:300", None, Some(IndexValue::I64(300)));
let file = dir.path().join("plain-file");
std::fs::write(&file, b"")?;
// the segment directory is a regular file, so its manifest will not open
let e = w.slide(b"t.ts", &mut seg, &file).unwrap_err();
assert!(matches!(e, kevy_window::ColdError::Seg(_)));Reopen
The segment just written would not reopen.
use kevy_window::ColdError;
let e = ColdError::Reopen { file: "idx-74-0.seg".into(), source: kevy_seg::SegError::Corrupt("footer") };
assert!(e.to_string().starts_with("reopen idx-74-0.seg: "));
assert!(std::error::Error::source(&e).is_some());Fields
§
file: StringThe segment’s file name.
use kevy_window::ColdError;
let e = ColdError::Reopen { file: "idx-74-0.seg".into(), source: kevy_seg::SegError::Corrupt("footer") };
let ColdError::Reopen { file, .. } = &e else { unreachable!() };
assert_eq!(file, "idx-74-0.seg");§
source: SegErrorWhy it would not reopen.
use kevy_window::ColdError;
let e = ColdError::Reopen { file: "idx-74-0.seg".into(), source: kevy_seg::SegError::Corrupt("footer") };
let ColdError::Reopen { source, .. } = &e else { unreachable!() };
assert!(matches!(source, kevy_seg::SegError::Corrupt("footer")));CorruptKey
A cold key that does not decode.
let e = kevy_window::ColdError::CorruptKey;
assert_eq!(e.to_string(), "corrupt cold key");
assert!(std::error::Error::source(&e).is_none());CorruptPayload
A cold payload that does not decode.
let e = kevy_window::ColdError::CorruptPayload;
assert_eq!(e.to_string(), "corrupt cold payload");Trait Implementations§
Source§impl Error for ColdError
impl Error for ColdError
Source§fn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§fn description(&self) -> &str
fn description(&self) -> &str
👎Deprecated since 1.42.0:
use the Display impl or to_string()
Auto Trait Implementations§
impl !RefUnwindSafe for ColdError
impl !UnwindSafe for ColdError
impl Freeze for ColdError
impl Send for ColdError
impl Sync for ColdError
impl Unpin for ColdError
impl UnsafeUnpin for ColdError
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more