Enum WidthError 

#[non_exhaustive]
pub enum WidthError {
    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 rejects an out-of-range value: the codec is dual-use, so unknown values are preserved via a #[catch_all] variant rather than rejected, and field access masks rather than validates. (Structural decode failures — EOF, a bad magic, an assert, invalid UTF-8 — are the separate BitError, not a WidthError.)

Examples

use bnb::{u4, WidthError};

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

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.

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 WidthError

fn clone(&self) -> WidthError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WidthError

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

Formats the value using the given formatter.

impl Display for WidthError

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

Formats the value using the given formatter.

impl Eq for WidthError

impl Error for WidthError

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<WidthError> for BitError

fn from(e: WidthError) -> 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 WidthError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for WidthError