Enum IntWidth 

pub enum IntWidth {
    I8,
    U8,
    I16,
    U16,
    I32,
    U32,
    U64,
}

Integer width types with real width semantics.

Does NOT include i64 — that stays as the default int type.

Variants

I8

U8

I16

U16

I32

U32

U64

Implementations

impl IntWidth

pub const ALL: [IntWidth; 7]

All 7 width variants.

pub const fn bits(self) -> u32

Number of bits in this width.

pub const fn is_signed(self) -> bool

Whether this is a signed integer type.

pub const fn is_unsigned(self) -> bool

Whether this is an unsigned integer type.

pub const fn mask(self) -> u64

Bit mask for the value range (e.g., 0xFF for 8-bit).

pub const fn sign_shift(self) -> u32

Bit position of the sign bit (e.g., 7 for i8).

pub const fn min_value(self) -> i64

Minimum value representable as i64. For unsigned types, this is 0.

pub const fn max_value(self) -> i64

Maximum value representable as i64. For U64, this returns i64::MAX (the max signed portion).

pub const fn max_unsigned(self) -> u64

Maximum value representable as u64 (meaningful for unsigned types).

pub const fn type_name(self) -> &'static str

Human-readable type name (e.g., “i8”, “u64”).

pub const fn truncate(self, value: i64) -> i64

Canonical truncation: wraps an i64 value to this width using two’s complement semantics.

For signed types: mask then sign-extend. For U64: identity (no truncation needed for i64→u64 bit reinterpret). For other unsigned: just mask.

pub const fn truncate_u64(self, value: u64) -> u64

Unsigned-safe truncation: wraps a u64 value to this width.

For signed types: mask then sign-extend (returned as u64 bit pattern). For unsigned types: just mask.

pub fn from_name(name: &str) -> Option<IntWidth>

Parse a width name (e.g., “i8”, “u64”) to an IntWidth.

impl IntWidth

pub fn join(a: IntWidth, b: IntWidth) -> Result<IntWidth, ()>

Join two widths for mixed-width arithmetic.

Rules:

• Same width → Ok(same)
• Different widths, same signedness → Ok(wider)
• Mixed sign: u8+i8→I16, u16+i16→I32, u32+i32→I64 (widen to next signed)
• u64 + any signed → Err(()) (compile error — no safe widening)

pub const fn in_range_i64(self, value: i64) -> bool

Check if a given i64 value is in range for this width.

pub const fn in_range_u64(self, value: u64) -> bool

Check if a given u64 value is in range for this width.

Trait Implementations

impl Clone for IntWidth

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for IntWidth

impl Debug for IntWidth

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for IntWidth

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for IntWidth

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

Formats the value using the given formatter.

impl Eq for IntWidth

impl Hash for IntWidth

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for IntWidth

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for IntWidth

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for IntWidth