1.0.0[−][src]Trait peroxide::structure::matrix::Error
Error
is a trait representing the basic expectations for error values,
i.e., values of type E
in Result<T, E>
. Errors must describe
themselves through the Display
and Debug
traits, and may provide
cause chain information:
The cause
method is generally used when errors cross "abstraction
boundaries", i.e., when a one module must report an error that is "caused"
by an error from a lower-level module. This setup makes it possible for the
high-level module to provide its own errors that do not commit to any
particular implementation, but also reveal some of its implementation for
debugging via cause
chains.
Provided methods
fn description(&self) -> &str
This method is soft-deprecated.
Although using it won’t cause compilation warning,
new code should use Display
instead
and new impl
s can omit it.
To obtain error description as a string, use to_string()
.
Examples
match "xc".parse::<u32>() { Err(e) => { // Print `e` itself, not `e.description()`. println!("Error: {}", e); } _ => println!("No error"), }
fn cause(&self) -> Option<&dyn Error>
replaced by Error::source, which can support downcasting
The lower-level cause of this error, if any.
Examples
use std::error::Error; use std::fmt; #[derive(Debug)] struct SuperError { side: SuperErrorSideKick, } impl fmt::Display for SuperError { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!(f, "SuperError is here!") } } impl Error for SuperError { fn description(&self) -> &str { "I'm the superhero of errors" } fn cause(&self) -> Option<&Error> { Some(&self.side) } } #[derive(Debug)] struct SuperErrorSideKick; impl fmt::Display for SuperErrorSideKick { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!(f, "SuperErrorSideKick is here!") } } impl Error for SuperErrorSideKick { fn description(&self) -> &str { "I'm SuperError side kick" } } fn get_super_error() -> Result<(), SuperError> { Err(SuperError { side: SuperErrorSideKick }) } fn main() { match get_super_error() { Err(e) => { println!("Error: {}", e.description()); println!("Caused by: {}", e.cause().unwrap()); } _ => println!("No error"), } }
fn source(&self) -> Option<&(dyn Error + 'static)>
1.30.0
The lower-level source of this error, if any.
Examples
use std::error::Error; use std::fmt; #[derive(Debug)] struct SuperError { side: SuperErrorSideKick, } impl fmt::Display for SuperError { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!(f, "SuperError is here!") } } impl Error for SuperError { fn description(&self) -> &str { "I'm the superhero of errors" } fn source(&self) -> Option<&(dyn Error + 'static)> { Some(&self.side) } } #[derive(Debug)] struct SuperErrorSideKick; impl fmt::Display for SuperErrorSideKick { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!(f, "SuperErrorSideKick is here!") } } impl Error for SuperErrorSideKick { fn description(&self) -> &str { "I'm SuperError side kick" } } fn get_super_error() -> Result<(), SuperError> { Err(SuperError { side: SuperErrorSideKick }) } fn main() { match get_super_error() { Err(e) => { println!("Error: {}", e.description()); println!("Caused by: {}", e.source().unwrap()); } _ => println!("No error"), } }
Methods
impl dyn Error + 'static
[src]
impl dyn Error + 'static
pub fn is<T>(&self) -> bool where | 1.3.0 [src] |
Returns true if the boxed type is the same as T
pub fn downcast_ref<T>(&self) -> Option<&T> where | 1.3.0 [src] |
Returns some reference to the boxed value if it is of type T
, or
None
if it isn't.
pub fn downcast_mut<T>(&mut self) -> Option<&mut T> where | 1.3.0 [src] |
Returns some mutable reference to the boxed value if it is of type T
, or
None
if it isn't.
impl dyn Error + 'static + Send
[src]
impl dyn Error + 'static + Send
pub fn is<T>(&self) -> bool where | 1.3.0 [src] |
Forwards to the method defined on the type Any
.
pub fn downcast_ref<T>(&self) -> Option<&T> where | 1.3.0 [src] |
Forwards to the method defined on the type Any
.
pub fn downcast_mut<T>(&mut self) -> Option<&mut T> where | 1.3.0 [src] |
Forwards to the method defined on the type Any
.
impl dyn Error + 'static + Sync + Send
[src]
impl dyn Error + 'static + Sync + Send
pub fn is<T>(&self) -> bool where | 1.3.0 [src] |
Forwards to the method defined on the type Any
.
pub fn downcast_ref<T>(&self) -> Option<&T> where | 1.3.0 [src] |
Forwards to the method defined on the type Any
.
pub fn downcast_mut<T>(&mut self) -> Option<&mut T> where | 1.3.0 [src] |
Forwards to the method defined on the type Any
.
impl dyn Error + 'static
[src]
impl dyn Error + 'static
pub fn downcast<T>( | 1.3.0 [src] |
Attempt to downcast the box to a concrete type.
impl dyn Error + 'static + Send
[src]
impl dyn Error + 'static + Send
pub fn downcast<T>( | 1.3.0 [src] |
Attempt to downcast the box to a concrete type.
impl dyn Error + 'static + Sync + Send
[src]
impl dyn Error + 'static + Sync + Send
pub fn downcast<T>( | 1.3.0 [src] |
Attempt to downcast the box to a concrete type.
Implementations on Foreign Types
impl Error for BorrowMutError
[src]
impl Error for BorrowMutError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for AllocErr
[src]
impl Error for AllocErr
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for CannotReallocInPlace
[src]
impl Error for CannotReallocInPlace
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for TryFromIntError
[src]
impl Error for TryFromIntError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for RecvError
[src]
impl Error for RecvError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for !
[src]
impl Error for !
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for SystemTimeError
[src]
impl Error for SystemTimeError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for BorrowError
[src]
impl Error for BorrowError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl<T> Error for SendError<T> where
T: Send,
[src]
impl<T> Error for SendError<T> where
T: Send,
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for IntoStringError
[src]
impl Error for IntoStringError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for RecvTimeoutError
[src]
impl Error for RecvTimeoutError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl<T> Error for TryLockError<T>
[src]
impl<T> Error for TryLockError<T>
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for DecodeUtf16Error
[src]
impl Error for DecodeUtf16Error
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl<W> Error for IntoInnerError<W> where
W: Send + Debug,
[src]
impl<W> Error for IntoInnerError<W> where
W: Send + Debug,
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for LayoutErr
[src]
impl Error for LayoutErr
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl<T> Error for TrySendError<T> where
T: Send,
[src]
impl<T> Error for TrySendError<T> where
T: Send,
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl<T> Error for PoisonError<T>
[src]
impl<T> Error for PoisonError<T>
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for ParseError
[src]
impl Error for ParseError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for CharTryFromError
[src]
impl Error for CharTryFromError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for ParseIntError
[src]
impl Error for ParseIntError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for FromUtf8Error
[src]
impl Error for FromUtf8Error
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for TryFromSliceError
[src]
impl Error for TryFromSliceError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for AddrParseError
[src]
impl Error for AddrParseError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for ParseBoolError
[src]
impl Error for ParseBoolError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for Error
[src]
impl Error for Error
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for ParseFloatError
[src]
impl Error for ParseFloatError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for JoinPathsError
[src]
impl Error for JoinPathsError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for FromUtf16Error
[src]
impl Error for FromUtf16Error
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for TryRecvError
[src]
impl Error for TryRecvError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for Utf8Error
[src]
impl Error for Utf8Error
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for ParseCharError
[src]
impl Error for ParseCharError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for NulError
[src]
impl Error for NulError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for VarError
[src]
impl Error for VarError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl<T> Error for Box<T> where
T: Error,
[src]
impl<T> Error for Box<T> where
T: Error,
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for StripPrefixError
[src]
impl Error for StripPrefixError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for FromBytesWithNulError
[src]
impl Error for FromBytesWithNulError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for Error
[src]
impl Error for Error
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for Error
[src]
impl Error for Error
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for FromUtf8Error
[src]
impl Error for FromUtf8Error
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for Utf8Error
[src]
impl Error for Utf8Error
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl<W> Error for IntoInnerError<W> where
W: Any,
[src]
impl<W> Error for IntoInnerError<W> where
W: Any,
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for DeserializeError
[src]
impl Error for DeserializeError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for Error
[src]
impl Error for Error
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for TimerError
[src]
impl Error for TimerError
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | 1.0.0 [src] |
replaced by Error::source, which can support downcasting
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |
impl Error for Error
[src]
impl Error for Error
fn description(&self) -> &str | [src] |
fn cause(&self) -> Option<&dyn Error> | [src] |
fn source(&self) -> Option<&(dyn Error + 'static)> | 1.30.0 [src] |