Trait ferrum::Error

pub trait Error: Debug + Display {
    fn description(&self) -> &str;

    fn cause(&self) -> Option<&Error> { ... }
}

Base functionality for all errors in Rust.

Required Methods

fn description(&self) -> &str

A short description of the error.

The description should only be used for a simple message. It should not contain newlines or sentence-ending punctuation, to facilitate embedding in larger user-facing strings. For showing formatted error messages with more information see Display.

Examples

use std::error::Error;

match "xc".parse::<u32>() {
    Err(e) => {
        println!("Error: {}", e.description());
    }
    _ => println!("No error"),
}

Provided Methods

fn cause(&self) -> Option<&Error>

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"),
    }
}

Methods

impl Error + 'static

fn is<T>(&self) -> bool where
    T: 'static + Error, 

Returns true if the boxed type is the same as T

fn downcast_ref<T>(&self) -> Option<&T> where
    T: 'static + Error, 

Returns some reference to the boxed value if it is of type T, or None if it isn't.

fn downcast_mut<T>(&mut self) -> Option<&mut T> where
    T: 'static + Error, 

Returns some mutable reference to the boxed value if it is of type T, or None if it isn't.

impl Error + 'static + Send

fn is<T>(&self) -> bool where
    T: 'static + Error, 

Forwards to the method defined on the type Any.

fn downcast_ref<T>(&self) -> Option<&T> where
    T: 'static + Error, 

Forwards to the method defined on the type Any.

fn downcast_mut<T>(&mut self) -> Option<&mut T> where
    T: 'static + Error, 

Forwards to the method defined on the type Any.

impl Error + 'static + Send + Sync

fn is<T>(&self) -> bool where
    T: 'static + Error, 

Forwards to the method defined on the type Any.

fn downcast_ref<T>(&self) -> Option<&T> where
    T: 'static + Error, 

Forwards to the method defined on the type Any.

fn downcast_mut<T>(&mut self) -> Option<&mut T> where
    T: 'static + Error, 

Forwards to the method defined on the type Any.

impl Error + 'static

fn downcast<T>(
    self: Box<Error + 'static>
) -> Result<Box<T>, Box<Error + 'static>> where
    T: 'static + Error, 

Attempt to downcast the box to a concrete type.

impl Error + 'static + Send

fn downcast<T>(
    self: Box<Error + 'static + Send>
) -> Result<Box<T>, Box<Error + 'static + Send>> where
    T: 'static + Error, 

Attempt to downcast the box to a concrete type.

impl Error + 'static + Send + Sync

fn downcast<T>(
    self: Box<Error + 'static + Send + Sync>
) -> Result<Box<T>, Box<Error + 'static + Send + Sync>> where
    T: 'static + Error, 

Attempt to downcast the box to a concrete type.

Trait Implementations

impl Trait for Error + 'static + Send + Sync

impl Trait for Error + 'static + Send

impl Trait for Error + 'static + Sync

Implementations on Foreign Types

impl Error for ParseError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for Error

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl<T> Error for SendError<T> where
    T: Any, 

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl<T> Error for SendError<T> where
    T: Any, 

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl<T, E> Error for SendError<T, E> where
    E: Any,
    T: Any, 

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl<T> Error for TrySendError<T> where
    T: Any, 

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl<E> Error for SharedError<E> where
    E: Error, 

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for Canceled

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for DecodeError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for CharTryFromError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for IntoStringError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl<T> Error for TrySendError<T> where
    T: Send, 

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for DecodeUtf16Error

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for JoinPathsError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for CharsError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for Error

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for CannotReallocInPlace

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for BorrowError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for AllocErr

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for FromBytesWithNulError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for SystemTimeError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for VarError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for RecvError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for ParseBoolError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for ParseCharError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for ParseIntError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for NulError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl<T> Error for SendError<T> where
    T: Send, 

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for StripPrefixError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for TryRecvError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for ParseError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for FromUtf16Error

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl<T> Error for TryLockError<T>

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl<T> Error for Box<T> where
    T: Error, 

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for Utf8Error

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl<W> Error for IntoInnerError<W> where
    W: Send + Debug, 

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for AddrParseError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl<T> Error for PoisonError<T>

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for BorrowMutError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for TryFromIntError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for FromUtf8Error

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for RecvTimeoutError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for ParseFloatError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for Error

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for FrameTooBig

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for ShutdownLoggerError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for SetLoggerError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for FromStrError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for Error

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for TimerError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for OutOfRangeError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for ParseError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for ParseLevelError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for SetLoggerError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

impl Error for UriError

fn description(&self) -> &str

fn cause(&self) -> Option<&Error>

Implementors

• impl Error for !
• impl Error for ferrum::error::HyperError
• impl Error for FerrumError