Enum ruma_client::Error

#[non_exhaustive]pub enum Error<E> {
    AuthenticationRequired,
    IntoHttp(IntoHttpError),
    Url(UrlError),
    Response(ResponseError),
    FromHttpResponse(FromHttpResponseError<E>),
}

An error that can occur during client operations.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

AuthenticationRequired

Queried endpoint requires authentication but was called on an anonymous client.

IntoHttp(IntoHttpError)

Construction of the HTTP request failed (this should never happen).

Url(UrlError)

The request's URL is invalid (this should never happen).

Response(ResponseError)

Couldn't obtain an HTTP response (e.g. due to network or DNS issues).

FromHttpResponse(FromHttpResponseError<E>)

Converting the HTTP response to one of ruma's types failed.

Trait Implementations

impl<E: Debug> Debug for Error<E>

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

Formats the value using the given formatter.

impl<E> Display for Error<E>

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

Formats the value using the given formatter.

impl<E: Debug> Error for Error<E>

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.

fn description(&self) -> &str

Deprecated since 1.42.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 Error>

Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl<E> From<FromHttpResponseError<E>> for Error<E>

fn from(err: FromHttpResponseError<E>) -> Self

Performs the conversion.

impl<E> From<IntoHttpError> for Error<E>

fn from(err: IntoHttpError) -> Self

Performs the conversion.