#io-error #error #io #eq #clone

eieio

Error Implementing Eq + Clone replacing std::io::Error

1 stable release

1.0.0 May 17, 2020

#2013 in Rust patterns

Download history 3397/week @ 2023-11-26 4316/week @ 2023-12-03 3034/week @ 2023-12-10 3387/week @ 2023-12-17 2670/week @ 2023-12-24 3264/week @ 2023-12-31 2906/week @ 2024-01-07 3581/week @ 2024-01-14 4010/week @ 2024-01-21 3506/week @ 2024-01-28 4556/week @ 2024-02-04 3932/week @ 2024-02-11 4291/week @ 2024-02-18 4652/week @ 2024-02-25 4874/week @ 2024-03-03 1531/week @ 2024-03-10

15,582 downloads per month
Used in 7 crates (2 directly)

MIT license

6KB
114 lines

eieio — Error Implementing Eq + Clone replacing std::io::Error

eieio::Error is a replacement of std::io::Error which implements Eq + Clone. This type is intended as a "source" of other errors where a derived Eq + Clone implemented is desired.

// Constructs a standard io::Error...
let ioe = std::fs::read_dir("/dev/null").unwrap_err();

// Converts into an Eq + Clone error
let e1 = eieio::Error::from(ioe);
let e2 = e1.clone();
assert_eq!(e1, e2);

Clone

eieio::Error stores custom errors in an Arc rather than a Box to allow universal cloning.

Conversion from std::io::Error to eieio::Error may need to perform a copy of the entire custom error.

Equality

eieio::Error uses Arc::ptr_eq to compare equality of custom errors.

If the custom error carried by the original std::io::Error itself implements Eq, that custom equality is ignored:

use std::io::ErrorKind;

let e1 = eieio::Error::new(ErrorKind::Other, Box::from("foo"));
let e2 = eieio::Error::new(ErrorKind::Other, Box::from("foo"));
assert_ne!(e1, e2);

No runtime deps