1.0.0[−][src]Trait std::error::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 source method is generally used when errors cross "abstraction
boundaries". If one module must report an error that is caused by an error
from a lower-level module, it can allow access to that error via the
source method. This makes it possible for the high-level module to
provide its own errors while also revealing some of the implementation for
debugging via source 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 impls 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"), }Run
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"), } }Run
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"), } }Run
Methods
impl dyn Error + 'static[src]
impl dyn Error + 'staticpub fn is<T: Error + 'static>(&self) -> bool | 1.3.0 [src] |
Returns true if the boxed type is the same as T
pub fn downcast_ref<T: Error + 'static>(&self) -> Option<&T> | 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: Error + 'static>(&mut self) -> Option<&mut T> | 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 + Send + 'static[src]
impl dyn Error + Send + 'staticpub fn is<T: Error + 'static>(&self) -> bool | 1.3.0 [src] |
Forwards to the method defined on the type Any.
pub fn downcast_ref<T: Error + 'static>(&self) -> Option<&T> | 1.3.0 [src] |
Forwards to the method defined on the type Any.
pub fn downcast_mut<T: Error + 'static>(&mut self) -> Option<&mut T> | 1.3.0 [src] |
Forwards to the method defined on the type Any.
impl dyn Error + Send + Sync + 'static[src]
impl dyn Error + Send + Sync + 'staticpub fn is<T: Error + 'static>(&self) -> bool | 1.3.0 [src] |
Forwards to the method defined on the type Any.
pub fn downcast_ref<T: Error + 'static>(&self) -> Option<&T> | 1.3.0 [src] |
Forwards to the method defined on the type Any.
pub fn downcast_mut<T: Error + 'static>(&mut self) -> Option<&mut T> | 1.3.0 [src] |
Forwards to the method defined on the type Any.
impl dyn Error[src]
impl dyn Errorpub fn downcast<T: Error + 'static>( | 1.3.0 [src] |
Attempt to downcast the box to a concrete type.
impl dyn Error + Send[src]
impl dyn Error + Sendpub fn downcast<T: Error + 'static>( | 1.3.0 [src] |
Attempt to downcast the box to a concrete type.
impl dyn Error + Send + Sync[src]
impl dyn Error + Send + Syncpub fn downcast<T: Error + 'static>( | 1.3.0 [src] |
Attempt to downcast the box to a concrete type.
Implementations on Foreign Types
impl Error for TryFromSliceError[src]
impl Error for TryFromSliceErrorfn 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] |
Implementors
impl Error for VarError[src]
impl Error for VarErrorfn 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 ParseErrorfn 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 RecvTimeoutError[src]
impl Error for RecvTimeoutErrorfn 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 TryRecvError[src]
impl Error for TryRecvErrorfn 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 AllocErr[src]
impl Error for AllocErrfn 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 CannotReallocInPlacefn 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 LayoutErr[src]
impl Error for LayoutErrfn 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 BorrowErrorfn 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 BorrowMutError[src]
impl Error for BorrowMutErrorfn 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 CharTryFromErrorfn 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 DecodeUtf16Error[src]
impl Error for DecodeUtf16Errorfn 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 ParseCharError[src]
impl Error for ParseCharErrorfn 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 JoinPathsError[src]
impl Error for JoinPathsErrorfn 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 FromBytesWithNulError[src]
impl Error for FromBytesWithNulErrorfn 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 IntoStringError[src]
impl Error for IntoStringErrorfn 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 NulError[src]
impl Error for NulErrorfn 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 std::fmt::Error[src]
impl Error for std::fmt::Errorfn 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 std::io::Error[src]
impl Error for std::io::Errorfn 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 AddrParseError[src]
impl Error for AddrParseErrorfn 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 ParseFloatErrorfn 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 ParseIntError[src]
impl Error for ParseIntErrorfn 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 TryFromIntError[src]
impl Error for TryFromIntErrorfn 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 StripPrefixError[src]
impl Error for StripPrefixErrorfn 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 ParseBoolErrorfn 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 Utf8Error[src]
impl Error for Utf8Errorfn 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 FromUtf16Errorfn 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 FromUtf8Errorfn 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 RecvError[src]
impl Error for RecvErrorfn 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 SystemTimeError[src]
impl Error for SystemTimeErrorfn 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 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<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<T: Error> Error for Box<T>[src]
impl<T: Error> Error for Box<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<T: Send> Error for TrySendError<T>[src]
impl<T: Send> Error for TrySendError<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<T: Send> Error for SendError<T>[src]
impl<T: Send> Error for SendError<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<W: Send + Debug> Error for IntoInnerError<W>[src]
impl<W: Send + Debug> Error for IntoInnerError<W>