Enum serenity::Error

pub enum Error {
    Decode(&'static str, Value),
    Format(FormatError),
    Io(IoError),
    Json(JsonError),
    Model(ModelError),
    Num(ParseIntError),
    ExceededLimit(String, u32),
    Other(&'static str),
    Url(String),
    Client(ClientError),
    Gateway(GatewayError),
    Http(Box<HttpError>),
    Tungstenite(TungsteniteError),
    Opus(OpusError),
    Voice(VoiceError),
    // some variants omitted
}

A common error enum returned by most of the library's functionality within a custom Result.

The most common error types, the ClientError and GatewayError enums, are both wrapped around this in the form of the Client and Gateway variants.

Variants

Decode(&'static str, Value)

An error while decoding a payload.

Format(FormatError)

There was an error with a format.

Io(IoError)

An std::io error.

Json(JsonError)

An error from the serde_json crate.

Model(ModelError)

An error from the model module.

Num(ParseIntError)

An error occurred while parsing an integer.

ExceededLimit(String, u32)

Input exceeded a limit. Providing the input and the limit that's not supposed to be exceeded.

This only exists for the GuildId::ban and Member::ban functions. For their cases, it's the "reason".

Other(&'static str)

Some other error. This is only used for "Expected value " errors, when a more detailed error can not be easily provided via the Error::Decode variant.

Url(String)

An error from the url crate.

Client(ClientError)

A client error.

Gateway(GatewayError)

An error from the gateway module.

Http(Box<HttpError>)

An error from the http module.

Tungstenite(TungsteniteError)

An error from the tungstenite crate.

Opus(OpusError)

An error from the opus crate.

Voice(VoiceError)

Indicating an error within the voice module.

Trait Implementations

impl Debug for Error

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Display for Error

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Error for Error

fn description(&self) -> &str

Deprecated since 1.41.0:

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 StdError>

Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

impl From<Error> for Error

fn from(e: FormatError) -> Error

Performs the conversion.

impl From<Error> for Error

fn from(e: GatewayError) -> Error

Performs the conversion.

impl From<Error> for Error

fn from(e: IoError) -> Error

Performs the conversion.

impl From<Error> for Error

fn from(e: JsonError) -> Error

Performs the conversion.

impl From<Error> for Error

fn from(e: ModelError) -> Error

Performs the conversion.

impl From<Error> for Error

fn from(e: OpusError) -> Error

Performs the conversion.

impl From<Error> for Error

fn from(e: TungsteniteError) -> Error

Performs the conversion.

impl From<Error> for Error

fn from(e: HttpError) -> Error

Performs the conversion.

impl From<Error> for Error

fn from(e: ReqwestError) -> Error

Performs the conversion.

impl From<InvalidHeaderValue> for Error

fn from(e: InvalidHeaderValue) -> Error

Performs the conversion.

impl From<ParseIntError> for Error

fn from(e: ParseIntError) -> Error

Performs the conversion.

impl From<VoiceError> for Error

fn from(e: VoiceError) -> Error

Performs the conversion.