1.0.0[−][src]Trait geng_core::prelude::serde::de::StdError
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 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 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 get_super_error() -> Result<(), SuperError> { Err(SuperError { side: SuperErrorSideKick }) } fn main() { match get_super_error() { Err(e) => { println!("Error: {}", e); println!("Caused by: {}", e.source().unwrap()); } _ => println!("No error"), } }
fn backtrace(&self) -> Option<&Backtrace>
backtrace
)Returns a stack backtrace, if available, of where this error occurred.
This function allows inspecting the location, in code, of where an error
happened. The returned Backtrace
contains information about the stack
trace of the OS thread of execution of where the error originated from.
Note that not all errors contain a Backtrace
. Also note that a
Backtrace
may actually be empty. For more information consult the
Backtrace
type itself.
fn description(&self) -> &str
use the Display impl or to_string()
if let Err(e) = "xc".parse::<u32>() { // Print `e` itself, no need for description(). eprintln!("Error: {}", e); }
fn cause(&self) -> Option<&dyn Error>
replaced by Error::source, which can support downcasting
Implementations
impl dyn Error + 'static
[src]
pub fn is<T>(&self) -> bool where
T: 'static + Error,
1.3.0[src]
T: 'static + Error,
Returns true
if the boxed type is the same as T
pub fn downcast_ref<T>(&self) -> Option<&T> where
T: 'static + Error,
1.3.0[src]
T: 'static + Error,
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
T: 'static + Error,
1.3.0[src]
T: 'static + Error,
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]
pub fn is<T>(&self) -> bool where
T: 'static + Error,
1.3.0[src]
T: 'static + Error,
Forwards to the method defined on the type dyn Error
.
pub fn downcast_ref<T>(&self) -> Option<&T> where
T: 'static + Error,
1.3.0[src]
T: 'static + Error,
Forwards to the method defined on the type dyn Error
.
pub fn downcast_mut<T>(&mut self) -> Option<&mut T> where
T: 'static + Error,
1.3.0[src]
T: 'static + Error,
Forwards to the method defined on the type dyn Error
.
impl dyn Error + 'static + Sync + Send
[src]
pub fn is<T>(&self) -> bool where
T: 'static + Error,
1.3.0[src]
T: 'static + Error,
Forwards to the method defined on the type dyn Error
.
pub fn downcast_ref<T>(&self) -> Option<&T> where
T: 'static + Error,
1.3.0[src]
T: 'static + Error,
Forwards to the method defined on the type dyn Error
.
pub fn downcast_mut<T>(&mut self) -> Option<&mut T> where
T: 'static + Error,
1.3.0[src]
T: 'static + Error,
Forwards to the method defined on the type dyn Error
.
impl dyn Error + 'static
[src]
pub fn downcast<T>(
self: Box<dyn Error + 'static>
) -> Result<Box<T>, Box<dyn Error + 'static>> where
T: 'static + Error,
1.3.0[src]
self: Box<dyn Error + 'static>
) -> Result<Box<T>, Box<dyn Error + 'static>> where
T: 'static + Error,
Attempts to downcast the box to a concrete type.
pub fn chain(&self) -> Chainⓘ
[src]
error_iter
)Returns an iterator starting with the current error and continuing with
recursively calling source
.
If you want to omit the current error and only use its sources,
use skip(1)
.
Examples
#![feature(error_iter)] use std::error::Error; use std::fmt; #[derive(Debug)] struct A; #[derive(Debug)] struct B(Option<Box<dyn Error + 'static>>); impl fmt::Display for A { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { write!(f, "A") } } impl fmt::Display for B { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { write!(f, "B") } } impl Error for A {} impl Error for B { fn source(&self) -> Option<&(dyn Error + 'static)> { self.0.as_ref().map(|e| e.as_ref()) } } let b = B(Some(Box::new(A))); // let err : Box<Error> = b.into(); // or let err = &b as &(dyn Error); let mut iter = err.chain(); assert_eq!("B".to_string(), iter.next().unwrap().to_string()); assert_eq!("A".to_string(), iter.next().unwrap().to_string()); assert!(iter.next().is_none()); assert!(iter.next().is_none());
impl dyn Error + 'static + Send
[src]
pub fn downcast<T>(
self: Box<dyn Error + 'static + Send>
) -> Result<Box<T>, Box<dyn Error + 'static + Send>> where
T: 'static + Error,
1.3.0[src]
self: Box<dyn Error + 'static + Send>
) -> Result<Box<T>, Box<dyn Error + 'static + Send>> where
T: 'static + Error,
Attempts to downcast the box to a concrete type.
impl dyn Error + 'static + Sync + Send
[src]
pub fn downcast<T>(
self: Box<dyn Error + 'static + Sync + Send>
) -> Result<Box<T>, Box<dyn Error + 'static + Sync + Send>> where
T: 'static + Error,
1.3.0[src]
self: Box<dyn Error + 'static + Sync + Send>
) -> Result<Box<T>, Box<dyn Error + 'static + Sync + Send>> where
T: 'static + Error,
Attempts to downcast the box to a concrete type.
Trait Implementations
impl AsRef<dyn Error + 'static + Sync + Send> for Error
[src]
impl AsRef<dyn Error + 'static> for Error
[src]
Implementations on Foreign Types
impl Error for BorrowError
[src]
fn description(&self) -> &str
[src]
impl<T> Error for PoisonError<T>
[src]
fn description(&self) -> &str
[src]
impl Error for DecodeUtf16Error
[src]
fn description(&self) -> &str
[src]
impl Error for AllocErr
[src]
impl<W> Error for IntoInnerError<W> where
W: Send + Debug,
[src]
W: Send + Debug,
fn description(&self) -> &str
[src]
impl Error for TryReserveError
[src]
impl Error for Infallible
[src]
fn description(&self) -> &str
[src]
impl Error for VarError
[src]
fn description(&self) -> &str
[src]
impl Error for JoinPathsError
[src]
fn description(&self) -> &str
[src]
impl Error for ParseBoolError
[src]
fn description(&self) -> &str
[src]
impl Error for AccessError
[src]
impl<T> Error for TrySendError<T> where
T: Send,
[src]
T: Send,
fn description(&self) -> &str
[src]
impl Error for !
[src]
impl<T> Error for TryLockError<T>
[src]
impl Error for SystemTimeError
[src]
fn description(&self) -> &str
[src]
impl Error for IntoStringError
[src]
impl Error for StripPrefixError
[src]
fn description(&self) -> &str
[src]
impl Error for Utf8Error
[src]
fn description(&self) -> &str
[src]
impl Error for CharTryFromError
[src]
fn description(&self) -> &str
[src]
impl Error for RecvError
[src]
fn description(&self) -> &str
[src]
impl Error for FromVecWithNulError
[src]
impl Error for AddrParseError
[src]
fn description(&self) -> &str
[src]
impl Error for ParseCharError
[src]
fn description(&self) -> &str
[src]
impl Error for ParseIntError
[src]
fn description(&self) -> &str
[src]
impl Error for FromBytesWithNulError
[src]
fn description(&self) -> &str
[src]
impl Error for FromUtf8Error
[src]
fn description(&self) -> &str
[src]
impl<T> Error for SendError<T> where
T: Send,
[src]
T: Send,
fn description(&self) -> &str
[src]
impl Error for FromUtf16Error
[src]
fn description(&self) -> &str
[src]
impl Error for LayoutErr
[src]
impl Error for TryFromSliceError
[src]
fn description(&self) -> &str
[src]
impl Error for ParseFloatError
[src]
fn description(&self) -> &str
[src]
impl Error for RecvTimeoutError
[src]
fn description(&self) -> &str
[src]
impl Error for TryFromIntError
[src]
fn description(&self) -> &str
[src]
impl Error for TryRecvError
[src]
fn description(&self) -> &str
[src]
impl Error for BorrowMutError
[src]
fn description(&self) -> &str
[src]
impl Error for NulError
[src]
fn description(&self) -> &str
[src]
impl Error for Error
[src]
fn description(&self) -> &str
[src]
impl<T> Error for Box<T> where
T: Error,
[src]
T: Error,
fn description(&self) -> &str
[src]
fn cause(&self) -> Option<&dyn Error>
[src]
fn source(&self) -> Option<&(dyn Error + 'static)>
[src]
impl<E> Error for Compat<E> where
E: Debug + Display,
[src]
E: Debug + Display,
fn description(&self) -> &'static str
[src]
impl Error for Error
[src]
impl Error for Error
[src]
impl Error for DecodeError
fn description(&self) -> &str
fn cause(&self) -> Option<&dyn Error>
impl Error for RoundingError
[src]
fn description(&self) -> &str
[src]
impl Error for ParseError
[src]
fn description(&self) -> &str
[src]
impl Error for ParseError
[src]
fn description(&self) -> &str
[src]
impl Error for OutOfRangeError
[src]
fn description(&self) -> &str
[src]
impl Error for ParseColorError
fn description(&self) -> &str
impl Error for Void
fn description(&self) -> &str
fn cause(&self) -> Option<&dyn Error>
impl<Enum> Error for TryFromPrimitiveError<Enum> where
Enum: TryFromPrimitive,
Enum: TryFromPrimitive,
impl Error for ContextError
[src]
fn description(&self) -> &str
[src]
impl Error for CreationError
[src]
impl Error for OpenError
fn description(&self) -> &str
impl Error for ExternalError
impl Error for OsError
impl Error for XNotSupported
impl Error for BadIcon
impl<T> Error for EventLoopClosed<T> where
T: Debug,
T: Debug,
impl Error for NotSupportedError
impl Error for XError
impl Error for Error
impl Error for Error
[src]
fn description(&self) -> &str
[src]
impl Error for Error
fn description(&self) -> &str
fn cause(&self) -> Option<&dyn Error>
fn source(&self) -> Option<&(dyn Error + 'static)>
impl Error for BaseDirectoriesError
fn description(&self) -> &str
fn cause(&self) -> Option<&dyn Error>
impl Error for EmitterError
fn description(&self) -> &str
impl Error for Error
fn description(&self) -> &str
impl Error for Errno
fn description(&self) -> &str
impl Error for Error
fn description(&self) -> &str
impl Error for GlobalError
fn description(&self) -> &str
impl Error for ProtocolError
fn description(&self) -> &str
impl Error for ConnectError
fn description(&self) -> &str
impl<T> Error for TrySendError<T> where
T: Any,
T: Any,
fn description(&self) -> &str
impl<T> Error for SendError<T> where
T: Any,
T: Any,
fn description(&self) -> &str
impl Error for MessageParseError
fn description(&self) -> &str
impl Error for MessageWriteError
fn description(&self) -> &str
impl Error for ImageError
[src]
impl Error for DecodingError
[src]
impl Error for UnsupportedError
[src]
impl Error for ParameterError
[src]
impl Error for LimitError
[src]
impl Error for EncodingError
[src]
impl Error for TiffError
fn description(&self) -> &str
fn cause(&self) -> Option<&dyn Error>
impl Error for DecodingError
fn description(&self) -> &str
fn cause(&self) -> Option<&dyn Error>
impl Error for Error
impl Error for ThreadPoolBuildError
[src]
impl Error for DecodingError
impl Error for EncodingError
impl Error for CacheReadErr
[src]
impl Error for CacheWriteErr
[src]
impl Error for DecoderError
[src]
fn description(&self) -> &str
[src]
impl Error for Error
fn description(&self) -> &str
fn cause(&self) -> Option<&dyn Error>
impl Error for PauseStreamError
impl Error for HostUnavailable
impl Error for BuildStreamError
impl Error for PlayStreamError
impl Error for DevicesError
impl Error for BackendSpecificError
impl Error for SupportedFormatsError
impl Error for DeviceNameError
impl Error for DefaultFormatError
impl Error for StreamError
impl Error for Error
fn description(&self) -> &str
fn cause(&self) -> Option<&dyn Error>
impl Error for AudioReadError
impl Error for VorbisError
impl Error for HeaderReadError
impl Error for OggReadError
fn description(&self) -> &str
fn cause(&self) -> Option<&dyn Error>
impl Error for Error
fn description(&self) -> &str
fn cause(&self) -> Option<&dyn Error>
impl Error for Error
[src]
Loading content...
Implementors
impl Error for ErrorKind
[src]
impl Error for BernoulliError
[src]
impl Error for WeightedError
[src]
impl Error for geng_core::prelude::futures::channel::mpsc::SendError
[src]
impl Error for geng_core::prelude::futures::channel::mpsc::TryRecvError
[src]
impl Error for Canceled
[src]
impl Error for EnterError
[src]
impl Error for Aborted
[src]
impl Error for geng_core::prelude::futures::io::Error
[src]
fn description(&self) -> &str
[src]
fn cause(&self) -> Option<&dyn Error>
[src]
fn source(&self) -> Option<&(dyn Error + 'static)>
[src]
impl Error for SpawnError
[src]
impl Error for ParseLevelError
[src]
impl Error for SetLoggerError
[src]
impl Error for ReadError
[src]
impl Error for geng_core::prelude::rand::Error
[src]
impl Error for geng_core::prelude::serde::de::value::Error
[src]
fn description(&self) -> &str
[src]
impl Error for geng_core::prelude::serde_json::Error
[src]
impl Error for geng_core::prelude::structopt::clap::Error
[src]
fn description(&self) -> &str
[src]
impl<T> Error for geng_core::prelude::futures::channel::mpsc::TrySendError<T> where
T: Any,
[src]
T: Any,
impl<T, Item> Error for ReuniteError<T, Item> where
T: Any,
[src]
T: Any,