Enum grammers_mtproto::errors::DeserializeError

pub enum DeserializeError {
    BadAuthKey {
        got: i64,
        expected: i64,
    },
    BadMessageId {
        got: i64,
    },
    NegativeMessageLength {
        got: i32,
    },
    TooLongMessageLength {
        got: usize,
        max_length: usize,
    },
    TransportError {
        code: i32,
    },
    MessageBufferTooSmall,
    DecompressionFailed,
    UnexpectedConstructor {
        id: u32,
    },
    DecryptionError(DecryptionError),
}

The error type for the deserialization of server messages.

Variants

BadAuthKey

The server's authorization key did not match our expectations.

Fields of BadAuthKey

got: i64expected: i64

BadMessageId

The server's message ID did not match our expectations.

Fields of BadMessageId

got: i64

NegativeMessageLength

The server's message length was not strictly positive.

Fields of NegativeMessageLength

got: i32

TooLongMessageLength

The server's message length was past the buffer.

Fields of TooLongMessageLength

got: usizemax_length: usize

TransportError

The error occured at the transport level, making it impossible to deserialize any data. The absolute value indicates the HTTP error code. Some known, possible codes are:

• 404, if the authorization key used was not found, meaning that the server is not aware of the key used by the client, so it cannot be used to securely communicate with it.

• 429, if too many transport connections are established to the same IP address in a too-short lapse of time.

Fields of TransportError

code: i32

MessageBufferTooSmall

The received buffer is too small to contain a valid response message, or the response seemed valid at first but trying to deserialize it proved the buffer to be too small.

DecompressionFailed

The server responded with compressed data which we failed to decompress.

UnexpectedConstructor

While deserializing the response types one of them had a constructor that did not match our expectations. The invalid ID is contained within this variant.

Fields of UnexpectedConstructor

id: u32

DecryptionError(DecryptionError)

Attempting to decrypt the message failed in some way.

Trait Implementations

impl Clone for DeserializeError

fn clone(&self) -> DeserializeError

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for DeserializeError

impl Debug for DeserializeError

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

Formats the value using the given formatter.

impl Display for DeserializeError

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

Formats the value using the given formatter.

impl Error for DeserializeError

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 From<DecryptionError> for DeserializeError

fn from(error: DecryptionError) -> Self

Performs the conversion.

impl From<DeserializeError> for DeserializeError

fn from(error: DeserializeError) -> Self

Performs the conversion.

impl From<DeserializeError> for RequestError

fn from(error: DeserializeError) -> Self

Performs the conversion.