Skip to main content

Error

Enum Error 

Source
pub enum Error {
    BadMagic {
        expected: HexBytes,
        got: HexBytes,
    },
    Truncated {
        need: usize,
        at: usize,
        have: usize,
    },
    Malformed {
        at: usize,
        reason: String,
    },
    ImplausibleLength {
        what: &'static str,
        length: u64,
        limit: u64,
    },
    Binrw(Error),
}
Expand description

What went wrong decoding or encoding a Pro DJ Link message.

Variants§

§

BadMagic

The datagram does not carry the Pro DJ Link magic, or a message does not carry the magic its format requires.

Fields

§expected: HexBytes

What the format requires.

§got: HexBytes

What the bytes held.

§

Truncated

The buffer ends before a field this format requires.

For a stream protocol this is the expected outcome of trying to decode too early, so callers distinguish it from Error::Malformed to decide between “wait for more bytes” and “drop the connection”.

Fields

§need: usize

How many bytes the field needs.

§at: usize

Where in the buffer it starts.

§have: usize

How many bytes remain from there.

§

Malformed

A field holds a value the format does not allow. Unlike Error::Truncated, more bytes will not help.

Fields

§at: usize

Where the offending field starts.

§reason: String

What is wrong with it.

§

ImplausibleLength

A length prefix claims more than any real message carries. Rejected before allocating, so a corrupt or hostile word costs a parse failure rather than four gigabytes.

Fields

§what: &'static str

What was being read.

§length: u64

The length the bytes claimed.

§limit: u64

The ceiling this codec enforces.

§

Binrw(Error)

A binrw-derived codec failed.

Implementations§

Source§

impl Error

Source

pub fn is_truncated(&self) -> bool

True when more bytes could make this parse succeed.

The distinction that matters on a TCP stream: a dbserver message is framed by nothing but its own contents, so running off the end of the buffer means “wait”, and anything else means “this connection is not speaking the protocol”.

Trait Implementations§

Source§

impl Debug for Error

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Display for Error

Source§

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Error for Error

Source§

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

Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 · Source§

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

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Source§

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)
Provides type-based access to context intended for error reports. Read more
Source§

impl From<Error> for Error

Source§

fn from(source: Error) -> Self

Converts to this type from the input type.

Auto Trait Implementations§

§

impl !RefUnwindSafe for Error

§

impl !UnwindSafe for Error

§

impl Freeze for Error

§

impl Send for Error

§

impl Sync for Error

§

impl Unpin for Error

§

impl UnsafeUnpin for Error

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CustomError for T
where T: Display + Debug + Send + Sync + 'static,

Source§

fn as_any(&self) -> &(dyn Any + Sync + Send + 'static)

Source§

fn as_any_mut(&mut self) -> &mut (dyn Any + Sync + Send + 'static)

Source§

fn as_box_any(self: Box<T>) -> Box<dyn Any + Sync + Send>

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.