Enum Error 

pub enum Error {
    ValueTooLarge {
        value: u128,
        bits: u32,
    },
}

Errors from checked construction.

Currently the only fallible operation is UInt::try_new (and the TryFrom impls built on it). Decoding never fails: the codec is dual-use, so unknown values are preserved as Custom/catch-all rather than rejected, and field access masks rather than validates.

Examples

use bnb::{u4, Error};

let err = u4::try_new(20).unwrap_err(); // 20 doesn't fit in 4 bits
assert_eq!(err, Error::ValueTooLarge { value: 20, bits: 4 });
assert_eq!(err.to_string(), "value 20 does not fit in 4 bits");

Variants

ValueTooLarge

A value did not fit in the target integer’s bit width.

Fields

value: u128

The offending value.

bits: u32

The maximum number of bits available.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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 Eq for Error

impl Error for Error

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

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

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

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

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.

impl From<Error> for BitError

fn from(e: Error) -> Self

Bridges a construction error (e.g. UInt::try_new) into a codec error, so it ?-propagates inside a custom parse_with/write_with fn or a converter that returns BitError. The offset is unknown (0) — the codec’s own reads/writes carry the real bit offset; this is only for borrowed construction failures with no cursor context.

impl PartialEq for Error

fn eq(&self, other: &Error) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Error