Struct bnum::prelude::BInt

pub struct BInt<const N: usize> { /* private fields */ }

Big signed integer type, of fixed size which must be known at compile time.

Digits of the underlying BUint are stored in little endian (least significant digit first). This integer type aims to exactly replicate the behaviours of Rust’s built-in signed integer types: i8, i16, i32, i64, i128 and isize. The const generic parameter N is the number of digits that are stored in the underlying BUint.

BInt implements all the arithmetic traits from the core::ops module. The behaviour of the implementation of these traits is the same as for Rust’s primitive integers - i.e. in debug mode it panics on overflow, and in release mode it performs two’s complement wrapping (see https://doc.rust-lang.org/book/ch03-02-data-types.html#integer-overflow). However, an attempt to divide by zero or calculate a remainder with a divisor of zero will always panic, unless the checked_ methods are used, which never panic.

Implementations

impl<const N: usize> BInt<N>

Checked arithmetic methods which act on self: self.checked_.... Each method cannot panic and returns an Option<Self>. None is returned when overflow would have occurred or there was an attempt to divide by zero or calculate a remainder with a divisor of zero.

pub const fn checked_add(self, rhs: Self) -> Option<Self>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_add.

pub const fn checked_add_unsigned(self, rhs: BUint<N>) -> Option<Self>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_add_unsigned.

pub const fn checked_sub(self, rhs: Self) -> Option<Self>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_sub.

pub const fn checked_sub_unsigned(self, rhs: BUint<N>) -> Option<Self>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_sub_unsigned.

pub const fn checked_mul(self, rhs: Self) -> Option<Self>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_mul.

NB: this method is only const when the nightly feature is enabled.

pub const fn checked_div(self, rhs: Self) -> Option<Self>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_div.

NB: this method is only const when the nightly feature is enabled.

pub const fn checked_div_euclid(self, rhs: Self) -> Option<Self>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_div_euclid.

NB: this method is only const when the nightly feature is enabled.

pub const fn checked_rem(self, rhs: Self) -> Option<Self>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_rem.

NB: this method is only const when the nightly feature is enabled.

pub const fn checked_rem_euclid(self, rhs: Self) -> Option<Self>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_rem_euclid.

NB: this method is only const when the nightly feature is enabled.

pub const fn checked_neg(self) -> Option<Self>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_neg.

NB: this method is only const when the nightly feature is enabled.

pub const fn checked_shl(self, rhs: u32) -> Option<Self>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_shl.

NB: this method is only const when the nightly feature is enabled.

pub const fn checked_shr(self, rhs: u32) -> Option<Self>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_shr.

NB: this method is only const when the nightly feature is enabled.

pub const fn checked_abs(self) -> Option<Self>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_abs.

NB: this method is only const when the nightly feature is enabled.

pub const fn checked_pow(self, pow: u32) -> Option<Self>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_pow.

NB: this method is only const when the nightly feature is enabled.

pub const fn checked_next_multiple_of(self, rhs: Self) -> Option<Self>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_next_multiple_of.

NB: this method is only const when the nightly feature is enabled.

pub const fn checked_ilog(self, base: Self) -> Option<u32>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_ilog.

NB: this method is only const when the nightly feature is enabled.

pub const fn checked_ilog2(self) -> Option<u32>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_ilog2.

NB: this method is only const when the nightly feature is enabled.

pub const fn checked_ilog10(self) -> Option<u32>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.checked_ilog10.

NB: this method is only const when the nightly feature is enabled.

impl<const N: usize> BInt<N>

Associated constants for this type.

pub const MIN: Self = _

The minimum value that this type can represent.

Examples

use bnum::types::I512;

assert_eq!(!I512::MIN, I512::MAX);

pub const MAX: Self = _

The maximum value that this type can represent.

Examples

use bnum::types::I512;

assert_eq!(I512::MAX.wrapping_add(I512::ONE), I512::MIN);

pub const BITS: u32 = BUint<N>::BITS

The total number of bits that this type contains.

Examples

use bnum::types::I512;

assert_eq!(I512::BITS, 512);

pub const BYTES: u32 = BUint<N>::BYTES

The total number of bytes that this type contains.

Examples

use bnum::types::I512;

assert_eq!(I512::BYTES, 512 / 8);

pub const ZERO: Self = _

The value of 0 represented by this type.

Examples

use bnum::types::I512;

assert_eq!(I512::ZERO, I512::from(0u8));

pub const ONE: Self = _

The value of 1 represented by this type.

Examples

use bnum::types::I512;

assert_eq!(I512::ONE, I512::from(1u8));

pub const TWO: Self = _

The value of 2 represented by this type.

pub const THREE: Self = _

The value of 3 represented by this type.

pub const FOUR: Self = _

The value of 4 represented by this type.

pub const FIVE: Self = _

The value of 5 represented by this type.

pub const SIX: Self = _

The value of 6 represented by this type.

pub const SEVEN: Self = _

The value of 7 represented by this type.

pub const EIGHT: Self = _

The value of 8 represented by this type.

pub const NINE: Self = _

The value of 9 represented by this type.

pub const TEN: Self = _

The value of 10 represented by this type.

pub const NEG_ONE: Self = _

The value of -1 represented by this type.

pub const NEG_TWO: Self = _

The value of -2 represented by this type.

pub const NEG_THREE: Self = _

The value of -3 represented by this type.

pub const NEG_FOUR: Self = _

The value of -4 represented by this type.

pub const NEG_FIVE: Self = _

The value of -5 represented by this type.

pub const NEG_SIX: Self = _

The value of -6 represented by this type.

pub const NEG_SEVEN: Self = _

The value of -7 represented by this type.

pub const NEG_EIGHT: Self = _

The value of -8 represented by this type.

pub const NEG_NINE: Self = _

The value of -9 represented by this type.

pub const NEG_TEN: Self = _

The value of -10 represented by this type.

impl<const N: usize> BInt<N>

Methods which convert a BInt to and from data stored in different endianness.

pub const fn from_be(x: Self) -> Self

Converts an integer from big endian to the target’s endianness.

On big endian this is a no-op. On little endian the bytes are swapped.

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.from_be.

pub const fn from_le(x: Self) -> Self

Converts an integer from little endian to the target’s endianness.

On little endian this is a no-op. On big endian the bytes are swapped.

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.from_le.

pub const fn to_be(self) -> Self

Converts self from big endian to the target’s endianness.

On big endian this is a no-op. On little endian the bytes are swapped.

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.to_be.

pub const fn to_le(self) -> Self

Converts self from little endian to the target’s endianness.

On little endian this is a no-op. On big endian the bytes are swapped.

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.to_le.

pub const fn from_be_slice(slice: &[u8]) -> Option<Self>

Create an integer value from a slice of bytes in big endian. The value is wrapped in an Option as the integer represented by the slice of bytes may represent an integer too large to be represented by the type.

If the length of the slice is shorter than Self::BYTES, the slice is padded with zeros or ones at the start so that it’s length equals Self::BYTES. It is padded with ones if the bytes represent a negative integer, otherwise it is padded with zeros.

If the length of the slice is longer than Self::BYTES, None will be returned, unless the bytes represent a non-negative integer and leading zeros from the slice can be removed until the length of the slice equals Self::BYTES, or if the bytes represent a negative integer and leading ones from the slice can be removed until the length of the slice equals Self::BYTES.

For examples, see the from_be_slice method documentation for BUint.

NB: this method is only const when the nightly feature is enabled.

pub const fn from_le_slice(slice: &[u8]) -> Option<Self>

Creates an integer value from a slice of bytes in little endian. The value is wrapped in an Option as the bytes may represent an integer too large to be represented by the type.

If the length of the slice is shorter than Self::BYTES, the slice is padded with zeros or ones at the end so that it’s length equals Self::BYTES. It is padded with ones if the bytes represent a negative integer, otherwise it is padded with zeros.

If the length of the slice is longer than Self::BYTES, None will be returned, unless the bytes represent a non-negative integer and trailing zeros from the slice can be removed until the length of the slice equals Self::BYTES, or if the bytes represent a negative integer and trailing ones from the slice can be removed until the length of the slice equals Self::BYTES.

For examples, see the from_le_slice method documentation for BUint.

NB: this method is only const when the nightly feature is enabled.

pub const fn to_be_bytes(self) -> [u8; { _ }]

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.to_be_bytes.

This is supported on the crate feature nightly only.

pub const fn to_le_bytes(self) -> [u8; { _ }]

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.to_le_bytes.

This is supported on the crate feature nightly only.

pub const fn to_ne_bytes(self) -> [u8; { _ }]

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.to_ne_bytes.

This is supported on the crate feature nightly only.

pub const fn from_be_bytes(bytes: [u8; { _ }]) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.from_be_bytes.

This is supported on the crate feature nightly only.

pub const fn from_le_bytes(bytes: [u8; { _ }]) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.from_le_bytes.

This is supported on the crate feature nightly only.

pub const fn from_ne_bytes(bytes: [u8; { _ }]) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.from_ne_bytes.

This is supported on the crate feature nightly only.

impl<const N: usize> BInt<N>

Overflowing arithmetic methods which act on self: self.overflowing_.... Each method returns a tuple of type (Self, bool) where the first item of the tuple is the result of the calculation truncated to the number of bits of self, and the second item is a boolean which indicates whether overflow occurred (i.e. if the number of bits of the result of the calculation exceeded the number of bits of self).

pub const fn overflowing_add(self, rhs: Self) -> (Self, bool)

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.overflowing_add.

pub const fn overflowing_add_unsigned(self, rhs: BUint<N>) -> (Self, bool)

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.overflowing_add_unsigned.

pub const fn overflowing_sub(self, rhs: Self) -> (Self, bool)

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.overflowing_sub.

pub const fn overflowing_sub_unsigned(self, rhs: BUint<N>) -> (Self, bool)

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.overflowing_sub_unsigned.

pub const fn overflowing_mul(self, rhs: Self) -> (Self, bool)

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.overflowing_mul.

NB: this method is only const when the nightly feature is enabled.

pub const fn overflowing_div(self, rhs: Self) -> (Self, bool)

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.overflowing_div.

NB: this method is only const when the nightly feature is enabled.

pub const fn overflowing_div_euclid(self, rhs: Self) -> (Self, bool)

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.overflowing_div_euclid.

NB: this method is only const when the nightly feature is enabled.

pub const fn overflowing_rem(self, rhs: Self) -> (Self, bool)

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.overflowing_rem.

NB: this method is only const when the nightly feature is enabled.

pub const fn overflowing_rem_euclid(self, rhs: Self) -> (Self, bool)

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.overflowing_rem_euclid.

NB: this method is only const when the nightly feature is enabled.

pub const fn overflowing_neg(self) -> (Self, bool)

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.overflowing_neg.

NB: this method is only const when the nightly feature is enabled.

pub const fn overflowing_shl(self, rhs: u32) -> (Self, bool)

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.overflowing_shl.

NB: this method is only const when the nightly feature is enabled.

pub const fn overflowing_shr(self, rhs: u32) -> (Self, bool)

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.overflowing_shr.

NB: this method is only const when the nightly feature is enabled.

pub const fn overflowing_abs(self) -> (Self, bool)

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.overflowing_abs.

NB: this method is only const when the nightly feature is enabled.

pub const fn overflowing_pow(self, pow: u32) -> (Self, bool)

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.overflowing_pow.

NB: this method is only const when the nightly feature is enabled.

impl<const N: usize> BInt<N>

Methods which convert a BInt between different types in a given radix (base).

pub fn parse_bytes(buf: &[u8], radix: u32) -> Option<Self>

Converts a byte slice in a given base to an integer. The input slice must contain ascii/utf8 characters in [0-9a-zA-Z].

This function is equivalent to the from_str_radix function for a string slice equivalent to the byte slice and the same radix.

Returns None if the conversion of the byte slice to string slice fails or if a digit is larger than or equal to the given radix, otherwise the integer is wrapped in Some.

pub fn from_radix_be(buf: &[u8], radix: u32) -> Option<Self>

Converts a slice of big-endian digits in the given radix to an integer. The digits are first converted to an unsigned integer, then this is transmuted to a signed integer. Each u8 of the slice is interpreted as one digit of base radix of the number, so this function will return None if any digit is greater than or equal to radix, otherwise the integer is wrapped in Some.

For examples, see the from_radix_be method documentation for BUint.

pub fn from_radix_le(buf: &[u8], radix: u32) -> Option<Self>

Converts a slice of big-endian digits in the given radix to an integer. The digits are first converted to an unsigned integer, then this is transmuted to a signed integer. Each u8 of the slice is interpreted as one digit of base radix of the number, so this function will return None if any digit is greater than or equal to radix, otherwise the integer is wrapped in Some.

For examples, see the from_radix_le method documentation for BUint.

pub fn from_str_radix(src: &str, radix: u32) -> Result<Self, ParseIntError>

Converts a string slice in a given base to an integer.

The string is expected to be an optional + or - sign followed by digits. Leading and trailing whitespace represent an error. Digits are a subset of these characters, depending on radix:

• 0-9
• a-z
• A-Z

Panics

This function panics if radix is not in the range from 2 to 36 inclusive.

For examples, see the from_str_radix method documentation for BUint.

pub fn to_str_radix(&self, radix: u32) -> String

Returns the integer as a string in the given radix.

Panics

This function panics if radix is not in the range from 2 to 36 inclusive.

For examples, see the to_str_radix method documentation for BUint.

pub fn to_radix_be(&self, radix: u32) -> Vec<u8>

Returns the integer’s underlying representation as an unsigned integer in the given base in big-endian digit order.

Panics

This function panics if radix is not in the range from 2 to 256 inclusive.

For examples, see the to_radix_be method documentation for BUint

pub fn to_radix_le(&self, radix: u32) -> Vec<u8>

Returns the integer’s underlying representation as an unsigned integer in the given base in little-endian digit order.

Panics

This function panics if radix is not in the range from 2 to 256 inclusive.

For examples, see the to_radix_le method documentation for BUint.

impl<const N: usize> BInt<N>

Saturating arithmetic methods which act on self: self.saturating_.... For each method, if overflow or underflow occurs, the largest or smallest value that can be represented by Self is returned instead.

pub const fn saturating_add(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.saturating_add.

pub const fn saturating_add_unsigned(self, rhs: BUint<N>) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.saturating_add_unsigned.

pub const fn saturating_sub(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.saturating_sub.

pub const fn saturating_sub_unsigned(self, rhs: BUint<N>) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.saturating_sub_unsigned.

pub const fn saturating_mul(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.saturating_mul.

NB: this method is only const when the nightly feature is enabled.

pub const fn saturating_div(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.saturating_div.

NB: this method is only const when the nightly feature is enabled.

pub const fn saturating_neg(self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.saturating_neg.

NB: this method is only const when the nightly feature is enabled.

pub const fn saturating_abs(self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.saturating_abs.

NB: this method is only const when the nightly feature is enabled.

pub const fn saturating_pow(self, exp: u32) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.saturating_pow.

NB: this method is only const when the nightly feature is enabled.

impl<const N: usize> BInt<N>

Unchecked arithmetic methods which act on self: self.unchecked_.... Each method results in undefined behavior if overflow/underflow occurs, i.e. when the checked equivalent would return None.

pub unsafe fn unchecked_add(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.unchecked_add.

pub unsafe fn unchecked_sub(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.unchecked_sub.

pub unsafe fn unchecked_mul(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.unchecked_mul.

pub unsafe fn unchecked_shl(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.unchecked_shl.

pub unsafe fn unchecked_shr(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.unchecked_shr.

impl<const N: usize> BInt<N>

Wrapping arithmetic methods which act on self: self.wrapping_.... Each method returns of the calculation truncated to the number of bits of self, i.e. they each return the first item in the tuple returned by their overflowing equivalent.

pub const fn wrapping_add(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.wrapping_add.

pub const fn wrapping_add_unsigned(self, rhs: BUint<N>) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.wrapping_add_unsigned.

pub const fn wrapping_sub(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.wrapping_sub.

pub const fn wrapping_sub_unsigned(self, rhs: BUint<N>) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.wrapping_sub_unsigned.

pub const fn wrapping_mul(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.wrapping_mul.

pub const fn wrapping_div(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.wrapping_div.

NB: this method is only const when the nightly feature is enabled.

pub const fn wrapping_div_euclid(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.wrapping_div_euclid.

NB: this method is only const when the nightly feature is enabled.

pub const fn wrapping_rem(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.wrapping_rem.

NB: this method is only const when the nightly feature is enabled.

pub const fn wrapping_rem_euclid(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.wrapping_rem_euclid.

NB: this method is only const when the nightly feature is enabled.

pub const fn wrapping_neg(self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.wrapping_neg.

NB: this method is only const when the nightly feature is enabled.

pub const fn wrapping_shl(self, rhs: u32) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.wrapping_shl.

NB: this method is only const when the nightly feature is enabled.

pub const fn wrapping_shr(self, rhs: u32) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.wrapping_shr.

NB: this method is only const when the nightly feature is enabled.

pub const fn wrapping_abs(self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.wrapping_abs.

NB: this method is only const when the nightly feature is enabled.

pub const fn wrapping_pow(self, pow: u32) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.wrapping_pow.

impl<const N: usize> BInt<N>

pub const fn count_ones(self) -> u32

Returns the number of ones in the binary representation of self.

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.count_ones.

Examples

use bnum::types::I256;

let n = I256::from(0b010111101010000u16);
assert_eq!(n.count_ones(), 7);

pub const fn count_zeros(self) -> u32

Returns the number of zeros in the binary representation of self.

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.count_zeros.

Examples

use bnum::types::I256;

assert_eq!((!I256::ZERO).count_zeros(), 0);

pub const fn leading_zeros(self) -> u32

Returns the number of leading zeros in the binary representation of self.

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.leading_zeros.

Examples

use bnum::types::I256;

let n = I256::ZERO;
assert_eq!(n.leading_zeros(), 256);

pub const fn trailing_zeros(self) -> u32

Returns the number of trailing zeros in the binary representation of self.

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.trailing_zeros.

Examples

use bnum::types::I256;

let n = (!I256::ZERO) << 6u32;
assert_eq!(n.trailing_zeros(), 6);

pub const fn leading_ones(self) -> u32

Returns the number of leading ones in the binary representation of self.

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.leading_ones.

Examples

use bnum::types::I256;

let n = !I256::ZERO;
assert_eq!(n.leading_ones(), 256);

pub const fn trailing_ones(self) -> u32

Returns the number of trailing ones in the binary representation of self.

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.trailing_ones.

Examples

use bnum::types::I256;

let n = I256::from(0b1000101011011u16);
assert_eq!(n.trailing_ones(), 2);

pub const fn rotate_left(self, n: u32) -> Self

Shifts the bits to the left by a specified amount, n, wrapping the truncated bits to the end of the resulting integer.

Please note this isn’t the same operation as the << shifting operator!

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.rotate_left.

NB: this method is only const when the nightly feature is enabled.

pub const fn rotate_right(self, n: u32) -> Self

Shifts the bits to the left by a specified amount, n, wrapping the truncated bits to the end of the resulting integer.

Please note this isn’t the same operation as the >> shifting operator!

self.rotate_right(n) is equivalent to self.rotate_left(Self::BITS - n).

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.rotate_right.

NB: this method is only const when the nightly feature is enabled.

pub const fn swap_bytes(self) -> Self

Reverses the byte order of the integer.

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.swap_bytes.

Examples

use bnum::types::I256;

let n = I256::from(0x12345678901234567890123456789012i128);
assert_eq!(n.swap_bytes().swap_bytes(), n);

pub const fn reverse_bits(self) -> Self

Reverses the order of bits in the integer. The least significant bit becomes the most significant bit, second least-significant bit becomes second most-significant bit, etc.

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.reverse_bits.

Examples

use bnum::types::I256;

let n = I256::from(0x12345678901234567890123456789012i128);
assert_eq!(n.reverse_bits().reverse_bits(), n);

pub const fn unsigned_abs(self) -> BUint<N>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.unsigned_abs.

NB: this method is only const when the nightly feature is enabled.

pub const fn pow(self, exp: u32) -> Self

Raises self to the power of exp, using exponentiation by squaring.

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.pow.

Examples

use bnum::types::I256;

let n = I256::from(3u8);
assert_eq!(n.pow(5), (243u8).into());

NB: this method is only const when the nightly feature is enabled.

pub const fn div_euclid(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.div_euclid.

NB: this method is only const when the nightly feature is enabled.

pub const fn rem_euclid(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.rem_euclid.

NB: this method is only const when the nightly feature is enabled.

pub const fn abs(self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.abs.

NB: this method is only const when the nightly feature is enabled.

pub const fn signum(self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.signum.

pub const fn is_positive(self) -> bool

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.is_positive.

pub const fn is_negative(self) -> bool

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.is_negative.

pub const fn is_power_of_two(self) -> bool

Returns true if and only if self == 2^k for some integer k.

Examples

use bnum::types::I256;

let n = I256::from(1i16 << 12);
assert!(n.is_power_of_two());
let m = I256::from(90i8);
assert!(!m.is_power_of_two());
assert!(!((-n).is_power_of_two()));

pub const fn ilog(self, base: Self) -> u32

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.ilog.

NB: this method is only const when the nightly feature is enabled.

pub const fn ilog2(self) -> u32

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.ilog2.

NB: this method is only const when the nightly feature is enabled.

pub const fn ilog10(self) -> u32

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.ilog10.

NB: this method is only const when the nightly feature is enabled.

pub const fn abs_diff(self, other: Self) -> BUint<N>

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.abs_diff.

NB: this method is only const when the nightly feature is enabled.

pub const fn next_multiple_of(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.next_multiple_of.

NB: this method is only const when the nightly feature is enabled.

pub const fn div_floor(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.div_floor.

NB: this method is only const when the nightly feature is enabled.

pub const fn div_ceil(self, rhs: Self) -> Self

See also: https://doc.rust-lang.org/std/primitive.i64.html#method.div_ceil.

NB: this method is only const when the nightly feature is enabled.

impl<const N: usize> BInt<N>

pub const fn bits(&self) -> u32

Returns the smallest number of bits necessary to represent self.

This is equal to the size of the type in bits minus the leading zeros of self.

Examples

use bnum::types::I256;

assert_eq!(I256::from(0b1111001010100u16).bits(), 13);
assert_eq!(I256::ZERO.bits(), 0);

pub const fn bit(&self, b: u32) -> bool

Returns a boolean representing the bit in the given position (true if the bit is set). The least significant bit is at index 0, the most significant bit is at index Self::BITS - 1

Examples

use bnum::types::I256;

let n = I256::from(0b001010100101010101u32);
assert!(n.bit(0));
assert!(!n.bit(1));
assert!(!n.bit(I256::BITS - 1));

pub const fn is_zero(&self) -> bool

Returns whether self is zero.

Examples

use bnum::types::I256;

assert!(I256::ZERO.is_zero());
assert!(!I256::ONE.is_zero());

pub const fn is_one(&self) -> bool

Returns whether self is one.

Examples

use bnum::types::I256;

assert!(I256::ONE.is_one());
assert!(!I256::MAX.is_one());

pub const fn from_bits(bits: BUint<N>) -> Self

Creates a signed integer with bits as its underlying representation in two’s complement.

This method is faster for casting from a BUint to a BInt of the same size than using the As trait.

pub const fn to_bits(self) -> BUint<N>

This simply returns the underlying representation of the integer in two’s complement, as an unsigned integer.

This method is faster for casting from a BInt to a BUint of the same size than using the As trait.

Trait Implementations

impl<const N: usize> Add<&BInt<N>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the + operator.

const fn add(self, rhs: &BInt<N>) -> Self::Output

Performs the + operation.

impl<const N: usize> Add<&BInt<N>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the + operator.

const fn add(self, rhs: &BInt<N>) -> Self::Output

Performs the + operation.

impl<const N: usize> Add<BInt<N>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the + operator.

const fn add(self, rhs: BInt<N>) -> Self::Output

Performs the + operation.

impl<const N: usize> Add<BInt<N>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the + operator.

const fn add(self, rhs: Self) -> Self

Performs the + operation.

impl<const N: usize> AddAssign<&BInt<N>> for BInt<N>

const fn add_assign(&mut self, rhs: &BInt<N>)

Performs the += operation.

impl<const N: usize> AddAssign<BInt<N>> for BInt<N>

const fn add_assign(&mut self, rhs: BInt<N>)

Performs the += operation.

impl<const N: usize, const M: usize> AsPrimitive<BInt<M>> for BInt<N>

fn as_(self) -> BInt<M>

Convert a value to another, using the as operator.

impl<const N: usize, const M: usize> AsPrimitive<BInt<M>> for BUint<N>

fn as_(self) -> BInt<M>

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<BInt<N>> for bool

fn as_(self) -> BInt<N>

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<BInt<N>> for char

fn as_(self) -> BInt<N>

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<BInt<N>> for f32

fn as_(self) -> BInt<N>

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<BInt<N>> for f64

fn as_(self) -> BInt<N>

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<BInt<N>> for i128

fn as_(self) -> BInt<N>

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<BInt<N>> for i16

fn as_(self) -> BInt<N>

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<BInt<N>> for i32

fn as_(self) -> BInt<N>

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<BInt<N>> for i64

fn as_(self) -> BInt<N>

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<BInt<N>> for i8

fn as_(self) -> BInt<N>

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<BInt<N>> for isize

fn as_(self) -> BInt<N>

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<BInt<N>> for u128

fn as_(self) -> BInt<N>

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<BInt<N>> for u16

fn as_(self) -> BInt<N>

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<BInt<N>> for u32

fn as_(self) -> BInt<N>

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<BInt<N>> for u64

fn as_(self) -> BInt<N>

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<BInt<N>> for u8

fn as_(self) -> BInt<N>

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<BInt<N>> for usize

fn as_(self) -> BInt<N>

Convert a value to another, using the as operator.

impl<const N: usize, const M: usize> AsPrimitive<BUint<M>> for BInt<N>

fn as_(self) -> BUint<M>

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<f32> for BInt<N>

fn as_(self) -> f32

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<f64> for BInt<N>

fn as_(self) -> f64

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<i128> for BInt<N>

fn as_(self) -> i128

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<i16> for BInt<N>

fn as_(self) -> i16

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<i32> for BInt<N>

fn as_(self) -> i32

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<i64> for BInt<N>

fn as_(self) -> i64

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<i8> for BInt<N>

fn as_(self) -> i8

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<isize> for BInt<N>

fn as_(self) -> isize

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<u128> for BInt<N>

fn as_(self) -> u128

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<u16> for BInt<N>

fn as_(self) -> u16

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<u32> for BInt<N>

fn as_(self) -> u32

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<u64> for BInt<N>

fn as_(self) -> u64

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<u8> for BInt<N>

fn as_(self) -> u8

Convert a value to another, using the as operator.

impl<const N: usize> AsPrimitive<usize> for BInt<N>

fn as_(self) -> usize

Convert a value to another, using the as operator.

impl<const N: usize> Binary for BInt<N>

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

Formats the value using the given formatter.

impl<const N: usize> BitAnd<&BInt<N>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the & operator.

const fn bitand(self, rhs: &BInt<N>) -> Self::Output

Performs the & operation.

impl<const N: usize> BitAnd<&BInt<N>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the & operator.

const fn bitand(self, rhs: &BInt<N>) -> Self::Output

Performs the & operation.

impl<const N: usize> BitAnd<BInt<N>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the & operator.

const fn bitand(self, rhs: BInt<N>) -> Self::Output

Performs the & operation.

impl<const N: usize> BitAnd<BInt<N>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the & operator.

const fn bitand(self, rhs: Self) -> Self

Performs the & operation.

impl<const N: usize> BitAndAssign<&BInt<N>> for BInt<N>

const fn bitand_assign(&mut self, rhs: &BInt<N>)

Performs the &= operation.

impl<const N: usize> BitAndAssign<BInt<N>> for BInt<N>

const fn bitand_assign(&mut self, rhs: BInt<N>)

Performs the &= operation.

impl<const N: usize> BitOr<&BInt<N>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the | operator.

const fn bitor(self, rhs: &BInt<N>) -> Self::Output

Performs the | operation.

impl<const N: usize> BitOr<&BInt<N>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the | operator.

const fn bitor(self, rhs: &BInt<N>) -> Self::Output

Performs the | operation.

impl<const N: usize> BitOr<BInt<N>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the | operator.

const fn bitor(self, rhs: BInt<N>) -> Self::Output

Performs the | operation.

impl<const N: usize> BitOr<BInt<N>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the | operator.

const fn bitor(self, rhs: Self) -> Self

Performs the | operation.

impl<const N: usize> BitOrAssign<&BInt<N>> for BInt<N>

const fn bitor_assign(&mut self, rhs: &BInt<N>)

Performs the |= operation.

impl<const N: usize> BitOrAssign<BInt<N>> for BInt<N>

const fn bitor_assign(&mut self, rhs: BInt<N>)

Performs the |= operation.

impl<const N: usize> BitXor<&BInt<N>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the ^ operator.

const fn bitxor(self, rhs: &BInt<N>) -> Self::Output

Performs the ^ operation.

impl<const N: usize> BitXor<&BInt<N>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the ^ operator.

const fn bitxor(self, rhs: &BInt<N>) -> Self::Output

Performs the ^ operation.

impl<const N: usize> BitXor<BInt<N>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the ^ operator.

const fn bitxor(self, rhs: BInt<N>) -> Self::Output

Performs the ^ operation.

impl<const N: usize> BitXor<BInt<N>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the ^ operator.

const fn bitxor(self, rhs: Self) -> Self

Performs the ^ operation.

impl<const N: usize> BitXorAssign<&BInt<N>> for BInt<N>

const fn bitxor_assign(&mut self, rhs: &BInt<N>)

Performs the ^= operation.

impl<const N: usize> BitXorAssign<BInt<N>> for BInt<N>

const fn bitxor_assign(&mut self, rhs: BInt<N>)

Performs the ^= operation.

impl<const N: usize> Bounded for BInt<N>

fn min_value() -> Self

Returns the smallest finite number this type can represent

fn max_value() -> Self

Returns the largest finite number this type can represent

impl<const N: usize, const M: usize> CastFrom<BInt<M>> for BInt<N>

const fn cast_from(from: BInt<M>) -> Self

impl<const N: usize, const M: usize> CastFrom<BInt<M>> for BUint<N>

const fn cast_from(from: BInt<M>) -> Self

impl<const N: usize> CastFrom<BInt<N>> for f32

fn cast_from(from: BInt<N>) -> Self

impl<const N: usize> CastFrom<BInt<N>> for f64

fn cast_from(from: BInt<N>) -> Self

impl<const N: usize> CastFrom<BInt<N>> for i128

const fn cast_from(from: BInt<N>) -> Self

impl<const N: usize> CastFrom<BInt<N>> for i16

const fn cast_from(from: BInt<N>) -> Self

impl<const N: usize> CastFrom<BInt<N>> for i32

const fn cast_from(from: BInt<N>) -> Self

impl<const N: usize> CastFrom<BInt<N>> for i64

const fn cast_from(from: BInt<N>) -> Self

impl<const N: usize> CastFrom<BInt<N>> for i8

const fn cast_from(from: BInt<N>) -> Self

impl<const N: usize> CastFrom<BInt<N>> for isize

const fn cast_from(from: BInt<N>) -> Self

impl<const N: usize> CastFrom<BInt<N>> for u128

const fn cast_from(from: BInt<N>) -> Self

impl<const N: usize> CastFrom<BInt<N>> for u16

const fn cast_from(from: BInt<N>) -> Self

impl<const N: usize> CastFrom<BInt<N>> for u32

const fn cast_from(from: BInt<N>) -> Self

impl<const N: usize> CastFrom<BInt<N>> for u64

const fn cast_from(from: BInt<N>) -> Self

impl<const N: usize> CastFrom<BInt<N>> for u8

const fn cast_from(from: BInt<N>) -> Self

impl<const N: usize> CastFrom<BInt<N>> for usize

const fn cast_from(from: BInt<N>) -> Self

impl<const N: usize, const M: usize> CastFrom<BUint<M>> for BInt<N>

const fn cast_from(from: BUint<M>) -> Self

impl<const N: usize> CastFrom<bool> for BInt<N>

const fn cast_from(from: bool) -> Self

impl<const N: usize> CastFrom<char> for BInt<N>

const fn cast_from(from: char) -> Self

impl<const N: usize> CastFrom<f32> for BInt<N>

fn cast_from(from: f32) -> Self

impl<const N: usize> CastFrom<f64> for BInt<N>

fn cast_from(from: f64) -> Self

impl<const N: usize> CastFrom<i128> for BInt<N>

const fn cast_from(from: i128) -> Self

impl<const N: usize> CastFrom<i16> for BInt<N>

const fn cast_from(from: i16) -> Self

impl<const N: usize> CastFrom<i32> for BInt<N>

const fn cast_from(from: i32) -> Self

impl<const N: usize> CastFrom<i64> for BInt<N>

const fn cast_from(from: i64) -> Self

impl<const N: usize> CastFrom<i8> for BInt<N>

const fn cast_from(from: i8) -> Self

impl<const N: usize> CastFrom<isize> for BInt<N>

const fn cast_from(from: isize) -> Self

impl<const N: usize> CastFrom<u128> for BInt<N>

const fn cast_from(from: u128) -> Self

impl<const N: usize> CastFrom<u16> for BInt<N>

const fn cast_from(from: u16) -> Self

impl<const N: usize> CastFrom<u32> for BInt<N>

const fn cast_from(from: u32) -> Self

impl<const N: usize> CastFrom<u64> for BInt<N>

const fn cast_from(from: u64) -> Self

impl<const N: usize> CastFrom<u8> for BInt<N>

const fn cast_from(from: u8) -> Self

impl<const N: usize> CastFrom<usize> for BInt<N>

const fn cast_from(from: usize) -> Self

impl<const N: usize> CheckedAdd for BInt<N>

fn checked_add(&self, rhs: &Self) -> Option<Self>

Adds two numbers, checking for overflow. If overflow happens, None is returned.

impl<const N: usize> CheckedDiv for BInt<N>

fn checked_div(&self, rhs: &Self) -> Option<Self>

Divides two numbers, checking for underflow, overflow and division by zero. If any of that happens, None is returned.

impl<const N: usize> CheckedMul for BInt<N>

fn checked_mul(&self, rhs: &Self) -> Option<Self>

Multiplies two numbers, checking for underflow or overflow. If underflow or overflow happens, None is returned.

impl<const N: usize> CheckedNeg for BInt<N>

fn checked_neg(&self) -> Option<Self>

Negates a number, returning None for results that can’t be represented, like signed MIN values that can’t be positive, or non-zero unsigned values that can’t be negative.

impl<const N: usize> CheckedRem for BInt<N>

fn checked_rem(&self, rhs: &Self) -> Option<Self>

Finds the remainder of dividing two numbers, checking for underflow, overflow and division by zero. If any of that happens, None is returned.

impl<const N: usize> CheckedShl for BInt<N>

fn checked_shl(&self, rhs: u32) -> Option<Self>

Checked shift left. Computes self << rhs, returning None if rhs is larger than or equal to the number of bits in self.

impl<const N: usize> CheckedShr for BInt<N>

fn checked_shr(&self, rhs: u32) -> Option<Self>

Checked shift right. Computes self >> rhs, returning None if rhs is larger than or equal to the number of bits in self.

impl<const N: usize> CheckedSub for BInt<N>

fn checked_sub(&self, rhs: &Self) -> Option<Self>

Subtracts two numbers, checking for underflow. If underflow happens, None is returned.

impl<const N: usize> Clone for BInt<N>

fn clone(&self) -> BInt<N>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<const N: usize> Debug for BInt<N>

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

Formats the value using the given formatter.

impl<const N: usize> Default for BInt<N>

fn default() -> Self

Returns the default value of Self::ZERO.

impl<'de, const N: usize> Deserialize<'de> for BInt<N>

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
    __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<const N: usize> Display for BInt<N>

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

Formats the value using the given formatter.

impl<const N: usize> Distribution<BInt<N>> for Standard

fn sample<R: Rng + ?Sized>(&self, rng: &mut R) -> BInt<N>

Generate a random value of T, using rng as the source of randomness.

fn sample_iter<R>(self, rng: R) -> DistIter<Self, R, T>where
    R: Rng,
    Self: Sized,

Create an iterator that generates random values of T, using rng as the source of randomness.

fn map<F, S>(self, func: F) -> DistMap<Self, F, T, S>where
    F: Fn(T) -> S,
    Self: Sized,

Create a distribution of values of ‘S’ by mapping the output of Self through the closure F

impl<const N: usize> Div<&BInt<N>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the / operator.

const fn div(self, rhs: &BInt<N>) -> Self::Output

Performs the / operation.

impl<const N: usize> Div<&BInt<N>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the / operator.

const fn div(self, rhs: &BInt<N>) -> Self::Output

Performs the / operation.

impl<const N: usize> Div<BInt<N>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the / operator.

const fn div(self, rhs: BInt<N>) -> Self::Output

Performs the / operation.

impl<const N: usize> Div<BInt<N>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the / operator.

const fn div(self, rhs: Self) -> Self

Performs the / operation.

impl<const N: usize> DivAssign<&BInt<N>> for BInt<N>

const fn div_assign(&mut self, rhs: &BInt<N>)

Performs the /= operation.

impl<const N: usize> DivAssign<BInt<N>> for BInt<N>

const fn div_assign(&mut self, rhs: BInt<N>)

Performs the /= operation.

impl<const N: usize> From<bool> for BInt<N>

const fn from(small: bool) -> Self

Converts to this type from the input type.

impl<const N: usize> From<i128> for BInt<N>

const fn from(int: i128) -> Self

Converts to this type from the input type.

impl<const N: usize> From<i16> for BInt<N>

const fn from(int: i16) -> Self

Converts to this type from the input type.

impl<const N: usize> From<i32> for BInt<N>

const fn from(int: i32) -> Self

Converts to this type from the input type.

impl<const N: usize> From<i64> for BInt<N>

const fn from(int: i64) -> Self

Converts to this type from the input type.

impl<const N: usize> From<i8> for BInt<N>

const fn from(int: i8) -> Self

Converts to this type from the input type.

impl<const N: usize> From<isize> for BInt<N>

const fn from(int: isize) -> Self

Converts to this type from the input type.

impl<const N: usize> From<u128> for BInt<N>

const fn from(int: u128) -> Self

Converts to this type from the input type.

impl<const N: usize> From<u16> for BInt<N>

const fn from(int: u16) -> Self

Converts to this type from the input type.

impl<const N: usize> From<u32> for BInt<N>

const fn from(int: u32) -> Self

Converts to this type from the input type.

impl<const N: usize> From<u64> for BInt<N>

const fn from(int: u64) -> Self

Converts to this type from the input type.

impl<const N: usize> From<u8> for BInt<N>

const fn from(int: u8) -> Self

Converts to this type from the input type.

impl<const N: usize> From<usize> for BInt<N>

const fn from(int: usize) -> Self

Converts to this type from the input type.

impl<const N: usize> FromPrimitive for BInt<N>

fn from_u8(n: u8) -> Option<Self>

Converts an u8 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u16(n: u16) -> Option<Self>

Converts an u16 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u32(n: u32) -> Option<Self>

Converts an u32 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u64(n: u64) -> Option<Self>

Converts an u64 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u128(n: u128) -> Option<Self>

Converts an u128 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_usize(n: usize) -> Option<Self>

Converts a usize to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i8(n: i8) -> Option<Self>

Converts an i8 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i16(n: i16) -> Option<Self>

Converts an i16 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i32(n: i32) -> Option<Self>

Converts an i32 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i64(n: i64) -> Option<Self>

Converts an i64 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i128(n: i128) -> Option<Self>

Converts an i128 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_isize(n: isize) -> Option<Self>

Converts an isize to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_f32(f: f32) -> Option<Self>

Converts a f32 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_f64(f: f64) -> Option<Self>

Converts a f64 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

impl<const N: usize> FromStr for BInt<N>

type Err = ParseIntError

The associated error which can be returned from parsing.

fn from_str(src: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl<const N: usize> Hash for BInt<N>

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<const N: usize> Integer for BInt<N>

fn div_floor(&self, other: &Self) -> Self

Floored integer division.

fn mod_floor(&self, other: &Self) -> Self

Floored integer modulo, satisfying:

fn gcd(&self, other: &Self) -> Self

Greatest Common Divisor (GCD).

fn lcm(&self, other: &Self) -> Self

Lowest Common Multiple (LCM).

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

Deprecated, use is_multiple_of instead.

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

Returns true if self is a multiple of other.

fn is_even(&self) -> bool

Returns true if the number is even.

fn is_odd(&self) -> bool

Returns true if the number is odd.

fn div_rem(&self, other: &Self) -> (Self, Self)

Simultaneous truncated integer division and modulus. Returns (quotient, remainder).

fn div_ceil(&self, other: &Self) -> Self

Ceiled integer division.

fn gcd_lcm(&self, other: &Self) -> (Self, Self)

Greatest Common Divisor (GCD) and Lowest Common Multiple (LCM) together.

fn extended_gcd(&self, other: &Self) -> ExtendedGcd<Self>where
    Self: Clone,

Greatest common divisor and Bézout coefficients.

fn extended_gcd_lcm(&self, other: &Self) -> (ExtendedGcd<Self>, Self)where
    Self: Clone + Signed,

Greatest common divisor, least common multiple, and Bézout coefficients.

fn div_mod_floor(&self, other: &Self) -> (Self, Self)

Simultaneous floored integer division and modulus. Returns (quotient, remainder).

fn next_multiple_of(&self, other: &Self) -> Selfwhere
    Self: Clone,

Rounds up to nearest multiple of argument.

fn prev_multiple_of(&self, other: &Self) -> Selfwhere
    Self: Clone,

Rounds down to nearest multiple of argument.

impl<const N: usize> LowerExp for BInt<N>

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

Formats the value using the given formatter.

impl<const N: usize> LowerHex for BInt<N>

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

Formats the value using the given formatter.

impl<const N: usize> Mul<&BInt<N>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the * operator.

const fn mul(self, rhs: &BInt<N>) -> Self::Output

Performs the * operation.

impl<const N: usize> Mul<&BInt<N>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the * operator.

const fn mul(self, rhs: &BInt<N>) -> Self::Output

Performs the * operation.

impl<const N: usize> Mul<BInt<N>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the * operator.

const fn mul(self, rhs: BInt<N>) -> Self::Output

Performs the * operation.

impl<const N: usize> Mul<BInt<N>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the * operator.

const fn mul(self, rhs: Self) -> Self

Performs the * operation.

impl<const N: usize> MulAdd<BInt<N>, BInt<N>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the fused multiply-add.

fn mul_add(self, a: Self, b: Self) -> Self

Performs the fused multiply-add operation.

impl<const N: usize> MulAddAssign<BInt<N>, BInt<N>> for BInt<N>

fn mul_add_assign(&mut self, a: Self, b: Self)

Performs the fused multiply-add operation.

impl<const N: usize> MulAssign<&BInt<N>> for BInt<N>

const fn mul_assign(&mut self, rhs: &BInt<N>)

Performs the *= operation.

impl<const N: usize> MulAssign<BInt<N>> for BInt<N>

const fn mul_assign(&mut self, rhs: BInt<N>)

Performs the *= operation.

impl<const N: usize> Neg for &BInt<N>

type Output = BInt<N>

The resulting type after applying the - operator.

const fn neg(self) -> BInt<N>

Performs the unary - operation.

impl<const N: usize> Neg for BInt<N>

type Output = BInt<N>

The resulting type after applying the - operator.

const fn neg(self) -> Self

Performs the unary - operation.

impl<const N: usize> Not for &BInt<N>

type Output = BInt<N>

The resulting type after applying the ! operator.

const fn not(self) -> BInt<N>

Performs the unary ! operation.

impl<const N: usize> Not for BInt<N>

type Output = BInt<N>

The resulting type after applying the ! operator.

const fn not(self) -> Self

Performs the unary ! operation.

impl<const N: usize> Num for BInt<N>

type FromStrRadixErr = ParseIntError

fn from_str_radix(
    string: &str,
    radix: u32
) -> Result<Self, Self::FromStrRadixErr>

Convert from a string and radix (typically 2..=36).

impl<const N: usize> NumCast for BInt<N>

fn from<T: ToPrimitive>(_n: T) -> Option<Self>

Creates a number from another value that can be converted into a primitive via the ToPrimitive trait. If the source value cannot be represented by the target type, then None is returned.

impl<const N: usize> Octal for BInt<N>

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

Formats the value using the given formatter.

impl<const N: usize> One for BInt<N>

fn one() -> Self

Returns the multiplicative identity element of Self, 1.

fn is_one(&self) -> bool

Returns true if self is equal to the multiplicative identity.

fn set_one(&mut self)

Sets self to the multiplicative identity element of Self, 1.

impl<const N: usize> Ord for BInt<N>

const fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

const fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

const fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

const fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl<const N: usize> PartialEq<BInt<N>> for BInt<N>

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<const N: usize> PartialOrd<BInt<N>> for BInt<N>

const fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<const N: usize> Pow<u32> for BInt<N>

type Output = BInt<N>

The result after applying the operator.

fn pow(self, exp: u32) -> Self

Returns self to the power rhs.

impl<const N: usize> PrimInt for BInt<N>

fn count_ones(self) -> u32

Returns the number of ones in the binary representation of self.

fn count_zeros(self) -> u32

Returns the number of zeros in the binary representation of self.

fn leading_zeros(self) -> u32

Returns the number of leading zeros in the binary representation of self.

fn trailing_zeros(self) -> u32

Returns the number of trailing zeros in the binary representation of self.

fn rotate_left(self, n: u32) -> Self

Shifts the bits to the left by a specified amount, n, wrapping the truncated bits to the end of the resulting integer.

fn rotate_right(self, n: u32) -> Self

Shifts the bits to the right by a specified amount, n, wrapping the truncated bits to the beginning of the resulting integer.

fn swap_bytes(self) -> Self

Reverses the byte order of the integer.

fn from_be(x: Self) -> Self

Convert an integer from big endian to the target’s endianness.

fn from_le(x: Self) -> Self

Convert an integer from little endian to the target’s endianness.

fn to_be(self) -> Self

Convert self to big endian from the target’s endianness.

fn to_le(self) -> Self

Convert self to little endian from the target’s endianness.

fn pow(self, exp: u32) -> Self

Raises self to the power of exp, using exponentiation by squaring.

fn signed_shl(self, n: u32) -> Self

Shifts the bits to the left by a specified amount, n, filling zeros in the least significant bits.

fn signed_shr(self, n: u32) -> Self

Shifts the bits to the right by a specified amount, n, copying the “sign bit” in the most significant bits even for unsigned types.

fn unsigned_shl(self, n: u32) -> Self

Shifts the bits to the left by a specified amount, n, filling zeros in the least significant bits.

fn unsigned_shr(self, n: u32) -> Self

Shifts the bits to the right by a specified amount, n, filling zeros in the most significant bits.

fn leading_ones(self) -> u32

Returns the number of leading ones in the binary representation of self.

fn trailing_ones(self) -> u32

Returns the number of trailing ones in the binary representation of self.

fn reverse_bits(self) -> Self

Reverses the order of bits in the integer.

impl<'a, const N: usize> Product<&'a BInt<N>> for BInt<N>

fn product<I: Iterator<Item = &'a Self>>(iter: I) -> Self

Method which takes an iterator and generates Self from the elements by multiplying the items.

impl<const N: usize> Product<BInt<N>> for BInt<N>

fn product<I: Iterator<Item = Self>>(iter: I) -> Self

Method which takes an iterator and generates Self from the elements by multiplying the items.

impl<const N: usize> Rem<&BInt<N>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the % operator.

const fn rem(self, rhs: &BInt<N>) -> Self::Output

Performs the % operation.

impl<const N: usize> Rem<&BInt<N>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the % operator.

const fn rem(self, rhs: &BInt<N>) -> Self::Output

Performs the % operation.

impl<const N: usize> Rem<BInt<N>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the % operator.

const fn rem(self, rhs: BInt<N>) -> Self::Output

Performs the % operation.

impl<const N: usize> Rem<BInt<N>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the % operator.

const fn rem(self, rhs: Self) -> Self

Performs the % operation.

impl<const N: usize> RemAssign<&BInt<N>> for BInt<N>

const fn rem_assign(&mut self, rhs: &BInt<N>)

Performs the %= operation.

impl<const N: usize> RemAssign<BInt<N>> for BInt<N>

const fn rem_assign(&mut self, rhs: BInt<N>)

Performs the %= operation.

impl<const N: usize> Roots for BInt<N>

fn sqrt(&self) -> Self

Returns the truncated principal square root of an integer – ⌊√x⌋

fn cbrt(&self) -> Self

Returns the truncated principal cube root of an integer – if x >= 0 { ⌊∛x⌋ } else { ⌈∛x⌉ }

fn nth_root(&self, n: u32) -> Self

Returns the truncated principal nth root of an integer – if x >= 0 { ⌊ⁿ√x⌋ } else { ⌈ⁿ√x⌉ }

impl<const N: usize> SampleUniform for BInt<N>

type Sampler = UniformInt<BInt<N>>

The UniformSampler implementation supporting type X.

impl<const N: usize> Saturating for BInt<N>

fn saturating_add(self, rhs: Self) -> Self

Saturating addition operator. Returns a+b, saturating at the numeric bounds instead of overflowing.

fn saturating_sub(self, rhs: Self) -> Self

Saturating subtraction operator. Returns a-b, saturating at the numeric bounds instead of overflowing.

impl<const N: usize> SaturatingAdd for BInt<N>

fn saturating_add(&self, rhs: &Self) -> Self

Saturating addition. Computes self + other, saturating at the relevant high or low boundary of the type.

impl<const N: usize> SaturatingMul for BInt<N>

fn saturating_mul(&self, rhs: &Self) -> Self

Saturating multiplication. Computes self * other, saturating at the relevant high or low boundary of the type.

impl<const N: usize> SaturatingSub for BInt<N>

fn saturating_sub(&self, rhs: &Self) -> Self

Saturating subtraction. Computes self - other, saturating at the relevant high or low boundary of the type.

impl<const N: usize> Serialize for BInt<N>

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

Serialize this value into the given Serde serializer.

impl<const N: usize, const M: usize> Shl<&BInt<M>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &BInt<M>) -> Self::Output

Performs the << operation.

impl<const N: usize, const M: usize> Shl<&BInt<M>> for &BUint<N>

type Output = BUint<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &BInt<M>) -> Self::Output

Performs the << operation.

impl<const N: usize, const M: usize> Shl<&BInt<M>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &BInt<M>) -> Self::Output

Performs the << operation.

impl<const N: usize, const M: usize> Shl<&BInt<M>> for BUint<N>

type Output = BUint<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &BInt<M>) -> Self::Output

Performs the << operation.

impl<const N: usize, const M: usize> Shl<&BUint<M>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &BUint<M>) -> Self::Output

Performs the << operation.

impl<const N: usize, const M: usize> Shl<&BUint<M>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &BUint<M>) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&i128> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &i128) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&i128> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &i128) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&i16> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &i16) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&i16> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &i16) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&i32> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &i32) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&i32> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &i32) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&i64> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &i64) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&i64> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &i64) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&i8> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &i8) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&i8> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &i8) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&isize> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &isize) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&isize> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &isize) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&u128> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &u128) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&u128> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &u128) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&u16> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &u16) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&u16> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &u16) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&u32> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &u32) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&u32> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &u32) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&u64> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &u64) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&u64> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &u64) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&u8> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &u8) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&u8> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &u8) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&usize> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &usize) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<&usize> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: &usize) -> Self::Output

Performs the << operation.

impl<const N: usize, const M: usize> Shl<BInt<M>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: BInt<M>) -> Self::Output

Performs the << operation.

impl<const N: usize, const M: usize> Shl<BInt<M>> for &BUint<N>

type Output = BUint<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: BInt<M>) -> Self::Output

Performs the << operation.

impl<const N: usize, const M: usize> Shl<BInt<M>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: BInt<M>) -> Self

Performs the << operation.

impl<const N: usize, const M: usize> Shl<BInt<M>> for BUint<N>

type Output = BUint<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: BInt<M>) -> Self

Performs the << operation.

impl<const N: usize, const M: usize> Shl<BUint<M>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: BUint<M>) -> Self::Output

Performs the << operation.

impl<const N: usize, const M: usize> Shl<BUint<M>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: BUint<M>) -> Self

Performs the << operation.

impl<const N: usize> Shl<i128> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: i128) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<i128> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: i128) -> Self

Performs the << operation.

impl<const N: usize> Shl<i16> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: i16) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<i16> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: i16) -> Self

Performs the << operation.

impl<const N: usize> Shl<i32> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: i32) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<i32> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: i32) -> Self

Performs the << operation.

impl<const N: usize> Shl<i64> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: i64) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<i64> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: i64) -> Self

Performs the << operation.

impl<const N: usize> Shl<i8> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: i8) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<i8> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: i8) -> Self

Performs the << operation.

impl<const N: usize> Shl<isize> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: isize) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<isize> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: isize) -> Self

Performs the << operation.

impl<const N: usize> Shl<u128> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: u128) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<u128> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: u128) -> Self

Performs the << operation.

impl<const N: usize> Shl<u16> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: u16) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<u16> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: u16) -> Self

Performs the << operation.

impl<const N: usize> Shl<u32> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: u32) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<u32> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: u32) -> Self

Performs the << operation.

impl<const N: usize> Shl<u64> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: u64) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<u64> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: u64) -> Self

Performs the << operation.

impl<const N: usize> Shl<u8> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: u8) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<u8> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: u8) -> Self

Performs the << operation.

impl<const N: usize> Shl<usize> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: usize) -> Self::Output

Performs the << operation.

impl<const N: usize> Shl<usize> for BInt<N>

type Output = BInt<N>

The resulting type after applying the << operator.

const fn shl(self, rhs: usize) -> Self

Performs the << operation.

impl<const N: usize, const M: usize> ShlAssign<&BInt<M>> for BInt<N>

const fn shl_assign(&mut self, rhs: &BInt<M>)

Performs the <<= operation.

impl<const N: usize, const M: usize> ShlAssign<&BInt<M>> for BUint<N>

const fn shl_assign(&mut self, rhs: &BInt<M>)

Performs the <<= operation.

impl<const N: usize, const M: usize> ShlAssign<&BUint<M>> for BInt<N>

const fn shl_assign(&mut self, rhs: &BUint<M>)

Performs the <<= operation.

impl<const N: usize> ShlAssign<&i128> for BInt<N>

const fn shl_assign(&mut self, rhs: &i128)

Performs the <<= operation.

impl<const N: usize> ShlAssign<&i16> for BInt<N>

const fn shl_assign(&mut self, rhs: &i16)

Performs the <<= operation.

impl<const N: usize> ShlAssign<&i32> for BInt<N>

const fn shl_assign(&mut self, rhs: &i32)

Performs the <<= operation.

impl<const N: usize> ShlAssign<&i64> for BInt<N>

const fn shl_assign(&mut self, rhs: &i64)

Performs the <<= operation.

impl<const N: usize> ShlAssign<&i8> for BInt<N>

const fn shl_assign(&mut self, rhs: &i8)

Performs the <<= operation.

impl<const N: usize> ShlAssign<&isize> for BInt<N>

const fn shl_assign(&mut self, rhs: &isize)

Performs the <<= operation.

impl<const N: usize> ShlAssign<&u128> for BInt<N>

const fn shl_assign(&mut self, rhs: &u128)

Performs the <<= operation.

impl<const N: usize> ShlAssign<&u16> for BInt<N>

const fn shl_assign(&mut self, rhs: &u16)

Performs the <<= operation.

impl<const N: usize> ShlAssign<&u32> for BInt<N>

const fn shl_assign(&mut self, rhs: &u32)

Performs the <<= operation.

impl<const N: usize> ShlAssign<&u64> for BInt<N>

const fn shl_assign(&mut self, rhs: &u64)

Performs the <<= operation.

impl<const N: usize> ShlAssign<&u8> for BInt<N>

const fn shl_assign(&mut self, rhs: &u8)

Performs the <<= operation.

impl<const N: usize> ShlAssign<&usize> for BInt<N>

const fn shl_assign(&mut self, rhs: &usize)

Performs the <<= operation.

impl<const N: usize, const M: usize> ShlAssign<BInt<M>> for BInt<N>

const fn shl_assign(&mut self, rhs: BInt<M>)

Performs the <<= operation.

impl<const N: usize, const M: usize> ShlAssign<BInt<M>> for BUint<N>

const fn shl_assign(&mut self, rhs: BInt<M>)

Performs the <<= operation.

impl<const N: usize, const M: usize> ShlAssign<BUint<M>> for BInt<N>

const fn shl_assign(&mut self, rhs: BUint<M>)

Performs the <<= operation.

impl<const N: usize> ShlAssign<i128> for BInt<N>

const fn shl_assign(&mut self, rhs: i128)

Performs the <<= operation.

impl<const N: usize> ShlAssign<i16> for BInt<N>

const fn shl_assign(&mut self, rhs: i16)

Performs the <<= operation.

impl<const N: usize> ShlAssign<i32> for BInt<N>

const fn shl_assign(&mut self, rhs: i32)

Performs the <<= operation.

impl<const N: usize> ShlAssign<i64> for BInt<N>

const fn shl_assign(&mut self, rhs: i64)

Performs the <<= operation.

impl<const N: usize> ShlAssign<i8> for BInt<N>

const fn shl_assign(&mut self, rhs: i8)

Performs the <<= operation.

impl<const N: usize> ShlAssign<isize> for BInt<N>

const fn shl_assign(&mut self, rhs: isize)

Performs the <<= operation.

impl<const N: usize> ShlAssign<u128> for BInt<N>

const fn shl_assign(&mut self, rhs: u128)

Performs the <<= operation.

impl<const N: usize> ShlAssign<u16> for BInt<N>

const fn shl_assign(&mut self, rhs: u16)

Performs the <<= operation.

impl<const N: usize> ShlAssign<u32> for BInt<N>

const fn shl_assign(&mut self, rhs: u32)

Performs the <<= operation.

impl<const N: usize> ShlAssign<u64> for BInt<N>

const fn shl_assign(&mut self, rhs: u64)

Performs the <<= operation.

impl<const N: usize> ShlAssign<u8> for BInt<N>

const fn shl_assign(&mut self, rhs: u8)

Performs the <<= operation.

impl<const N: usize> ShlAssign<usize> for BInt<N>

const fn shl_assign(&mut self, rhs: usize)

Performs the <<= operation.

impl<const N: usize, const M: usize> Shr<&BInt<M>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &BInt<M>) -> Self::Output

Performs the >> operation.

impl<const N: usize, const M: usize> Shr<&BInt<M>> for &BUint<N>

type Output = BUint<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &BInt<M>) -> Self::Output

Performs the >> operation.

impl<const N: usize, const M: usize> Shr<&BInt<M>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &BInt<M>) -> Self::Output

Performs the >> operation.

impl<const N: usize, const M: usize> Shr<&BInt<M>> for BUint<N>

type Output = BUint<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &BInt<M>) -> Self::Output

Performs the >> operation.

impl<const N: usize, const M: usize> Shr<&BUint<M>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &BUint<M>) -> Self::Output

Performs the >> operation.

impl<const N: usize, const M: usize> Shr<&BUint<M>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &BUint<M>) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&i128> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &i128) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&i128> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &i128) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&i16> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &i16) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&i16> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &i16) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&i32> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &i32) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&i32> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &i32) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&i64> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &i64) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&i64> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &i64) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&i8> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &i8) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&i8> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &i8) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&isize> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &isize) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&isize> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &isize) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&u128> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &u128) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&u128> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &u128) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&u16> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &u16) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&u16> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &u16) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&u32> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &u32) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&u32> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &u32) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&u64> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &u64) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&u64> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &u64) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&u8> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &u8) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&u8> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &u8) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&usize> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &usize) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<&usize> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: &usize) -> Self::Output

Performs the >> operation.

impl<const N: usize, const M: usize> Shr<BInt<M>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: BInt<M>) -> Self::Output

Performs the >> operation.

impl<const N: usize, const M: usize> Shr<BInt<M>> for &BUint<N>

type Output = BUint<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: BInt<M>) -> Self::Output

Performs the >> operation.

impl<const N: usize, const M: usize> Shr<BInt<M>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: BInt<M>) -> Self

Performs the >> operation.

impl<const N: usize, const M: usize> Shr<BInt<M>> for BUint<N>

type Output = BUint<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: BInt<M>) -> Self

Performs the >> operation.

impl<const N: usize, const M: usize> Shr<BUint<M>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: BUint<M>) -> Self::Output

Performs the >> operation.

impl<const N: usize, const M: usize> Shr<BUint<M>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: BUint<M>) -> Self

Performs the >> operation.

impl<const N: usize> Shr<i128> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: i128) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<i128> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: i128) -> Self

Performs the >> operation.

impl<const N: usize> Shr<i16> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: i16) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<i16> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: i16) -> Self

Performs the >> operation.

impl<const N: usize> Shr<i32> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: i32) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<i32> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: i32) -> Self

Performs the >> operation.

impl<const N: usize> Shr<i64> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: i64) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<i64> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: i64) -> Self

Performs the >> operation.

impl<const N: usize> Shr<i8> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: i8) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<i8> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: i8) -> Self

Performs the >> operation.

impl<const N: usize> Shr<isize> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: isize) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<isize> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: isize) -> Self

Performs the >> operation.

impl<const N: usize> Shr<u128> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: u128) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<u128> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: u128) -> Self

Performs the >> operation.

impl<const N: usize> Shr<u16> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: u16) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<u16> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: u16) -> Self

Performs the >> operation.

impl<const N: usize> Shr<u32> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: u32) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<u32> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: u32) -> Self

Performs the >> operation.

impl<const N: usize> Shr<u64> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: u64) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<u64> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: u64) -> Self

Performs the >> operation.

impl<const N: usize> Shr<u8> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: u8) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<u8> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: u8) -> Self

Performs the >> operation.

impl<const N: usize> Shr<usize> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: usize) -> Self::Output

Performs the >> operation.

impl<const N: usize> Shr<usize> for BInt<N>

type Output = BInt<N>

The resulting type after applying the >> operator.

const fn shr(self, rhs: usize) -> Self

Performs the >> operation.

impl<const N: usize, const M: usize> ShrAssign<&BInt<M>> for BInt<N>

const fn shr_assign(&mut self, rhs: &BInt<M>)

Performs the >>= operation.

impl<const N: usize, const M: usize> ShrAssign<&BInt<M>> for BUint<N>

const fn shr_assign(&mut self, rhs: &BInt<M>)

Performs the >>= operation.

impl<const N: usize, const M: usize> ShrAssign<&BUint<M>> for BInt<N>

const fn shr_assign(&mut self, rhs: &BUint<M>)

Performs the >>= operation.

impl<const N: usize> ShrAssign<&i128> for BInt<N>

const fn shr_assign(&mut self, rhs: &i128)

Performs the >>= operation.

impl<const N: usize> ShrAssign<&i16> for BInt<N>

const fn shr_assign(&mut self, rhs: &i16)

Performs the >>= operation.

impl<const N: usize> ShrAssign<&i32> for BInt<N>

const fn shr_assign(&mut self, rhs: &i32)

Performs the >>= operation.

impl<const N: usize> ShrAssign<&i64> for BInt<N>

const fn shr_assign(&mut self, rhs: &i64)

Performs the >>= operation.

impl<const N: usize> ShrAssign<&i8> for BInt<N>

const fn shr_assign(&mut self, rhs: &i8)

Performs the >>= operation.

impl<const N: usize> ShrAssign<&isize> for BInt<N>

const fn shr_assign(&mut self, rhs: &isize)

Performs the >>= operation.

impl<const N: usize> ShrAssign<&u128> for BInt<N>

const fn shr_assign(&mut self, rhs: &u128)

Performs the >>= operation.

impl<const N: usize> ShrAssign<&u16> for BInt<N>

const fn shr_assign(&mut self, rhs: &u16)

Performs the >>= operation.

impl<const N: usize> ShrAssign<&u32> for BInt<N>

const fn shr_assign(&mut self, rhs: &u32)

Performs the >>= operation.

impl<const N: usize> ShrAssign<&u64> for BInt<N>

const fn shr_assign(&mut self, rhs: &u64)

Performs the >>= operation.

impl<const N: usize> ShrAssign<&u8> for BInt<N>

const fn shr_assign(&mut self, rhs: &u8)

Performs the >>= operation.

impl<const N: usize> ShrAssign<&usize> for BInt<N>

const fn shr_assign(&mut self, rhs: &usize)

Performs the >>= operation.

impl<const N: usize, const M: usize> ShrAssign<BInt<M>> for BInt<N>

const fn shr_assign(&mut self, rhs: BInt<M>)

Performs the >>= operation.

impl<const N: usize, const M: usize> ShrAssign<BInt<M>> for BUint<N>

const fn shr_assign(&mut self, rhs: BInt<M>)

Performs the >>= operation.

impl<const N: usize, const M: usize> ShrAssign<BUint<M>> for BInt<N>

const fn shr_assign(&mut self, rhs: BUint<M>)

Performs the >>= operation.

impl<const N: usize> ShrAssign<i128> for BInt<N>

const fn shr_assign(&mut self, rhs: i128)

Performs the >>= operation.

impl<const N: usize> ShrAssign<i16> for BInt<N>

const fn shr_assign(&mut self, rhs: i16)

Performs the >>= operation.

impl<const N: usize> ShrAssign<i32> for BInt<N>

const fn shr_assign(&mut self, rhs: i32)

Performs the >>= operation.

impl<const N: usize> ShrAssign<i64> for BInt<N>

const fn shr_assign(&mut self, rhs: i64)

Performs the >>= operation.

impl<const N: usize> ShrAssign<i8> for BInt<N>

const fn shr_assign(&mut self, rhs: i8)

Performs the >>= operation.

impl<const N: usize> ShrAssign<isize> for BInt<N>

const fn shr_assign(&mut self, rhs: isize)

Performs the >>= operation.

impl<const N: usize> ShrAssign<u128> for BInt<N>

const fn shr_assign(&mut self, rhs: u128)

Performs the >>= operation.

impl<const N: usize> ShrAssign<u16> for BInt<N>

const fn shr_assign(&mut self, rhs: u16)

Performs the >>= operation.

impl<const N: usize> ShrAssign<u32> for BInt<N>

const fn shr_assign(&mut self, rhs: u32)

Performs the >>= operation.

impl<const N: usize> ShrAssign<u64> for BInt<N>

const fn shr_assign(&mut self, rhs: u64)

Performs the >>= operation.

impl<const N: usize> ShrAssign<u8> for BInt<N>

const fn shr_assign(&mut self, rhs: u8)

Performs the >>= operation.

impl<const N: usize> ShrAssign<usize> for BInt<N>

const fn shr_assign(&mut self, rhs: usize)

Performs the >>= operation.

impl<const N: usize> Signed for BInt<N>

fn abs(&self) -> Self

Computes the absolute value.

fn abs_sub(&self, other: &Self) -> Self

The positive difference of two numbers.

fn signum(&self) -> Self

Returns the sign of the number.

fn is_positive(&self) -> bool

Returns true if the number is positive and false if the number is zero or negative.

fn is_negative(&self) -> bool

Returns true if the number is negative and false if the number is zero or positive.

impl<const N: usize> Sub<&BInt<N>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the - operator.

const fn sub(self, rhs: &BInt<N>) -> Self::Output

Performs the - operation.

impl<const N: usize> Sub<&BInt<N>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the - operator.

const fn sub(self, rhs: &BInt<N>) -> Self::Output

Performs the - operation.

impl<const N: usize> Sub<BInt<N>> for &BInt<N>

type Output = BInt<N>

The resulting type after applying the - operator.

const fn sub(self, rhs: BInt<N>) -> Self::Output

Performs the - operation.

impl<const N: usize> Sub<BInt<N>> for BInt<N>

type Output = BInt<N>

The resulting type after applying the - operator.

const fn sub(self, rhs: Self) -> Self

Performs the - operation.

impl<const N: usize> SubAssign<&BInt<N>> for BInt<N>

const fn sub_assign(&mut self, rhs: &BInt<N>)

Performs the -= operation.

impl<const N: usize> SubAssign<BInt<N>> for BInt<N>

const fn sub_assign(&mut self, rhs: BInt<N>)

Performs the -= operation.

impl<'a, const N: usize> Sum<&'a BInt<N>> for BInt<N>

fn sum<I: Iterator<Item = &'a Self>>(iter: I) -> Self

Method which takes an iterator and generates Self from the elements by “summing up” the items.

impl<const N: usize> Sum<BInt<N>> for BInt<N>

fn sum<I: Iterator<Item = Self>>(iter: I) -> Self

Method which takes an iterator and generates Self from the elements by “summing up” the items.

impl<const N: usize> ToPrimitive for BInt<N>

fn to_u8(&self) -> Option<u8>

Converts the value of self to a u8. If the value cannot be represented by a u8, then None is returned.

fn to_u16(&self) -> Option<u16>

Converts the value of self to a u16. If the value cannot be represented by a u16, then None is returned.

fn to_u32(&self) -> Option<u32>

Converts the value of self to a u32. If the value cannot be represented by a u32, then None is returned.

fn to_u64(&self) -> Option<u64>

Converts the value of self to a u64. If the value cannot be represented by a u64, then None is returned.

fn to_u128(&self) -> Option<u128>

Converts the value of self to a u128. If the value cannot be represented by a u128 (u64 under the default implementation), then None is returned.

fn to_usize(&self) -> Option<usize>

Converts the value of self to a usize. If the value cannot be represented by a usize, then None is returned.

fn to_i8(&self) -> Option<i8>

Converts the value of self to an i8. If the value cannot be represented by an i8, then None is returned.

fn to_i16(&self) -> Option<i16>

Converts the value of self to an i16. If the value cannot be represented by an i16, then None is returned.

fn to_i32(&self) -> Option<i32>

Converts the value of self to an i32. If the value cannot be represented by an i32, then None is returned.

fn to_i64(&self) -> Option<i64>

Converts the value of self to an i64. If the value cannot be represented by an i64, then None is returned.

fn to_i128(&self) -> Option<i128>

Converts the value of self to an i128. If the value cannot be represented by an i128 (i64 under the default implementation), then None is returned.

fn to_isize(&self) -> Option<isize>

Converts the value of self to an isize. If the value cannot be represented by an isize, then None is returned.

fn to_f32(&self) -> Option<f32>

Converts the value of self to an f32. Overflows may map to positive or negative inifinity, otherwise None is returned if the value cannot be represented by an f32.

fn to_f64(&self) -> Option<f64>

Converts the value of self to an f64. Overflows may map to positive or negative inifinity, otherwise None is returned if the value cannot be represented by an f64.

impl<const N: usize> TryFrom<BInt<N>> for i128

type Error = TryFromIntError

The type returned in the event of a conversion error.

const fn try_from(int: BInt<N>) -> Result<i128, Self::Error>

Performs the conversion.

impl<const N: usize> TryFrom<BInt<N>> for i16

type Error = TryFromIntError

The type returned in the event of a conversion error.

const fn try_from(int: BInt<N>) -> Result<i16, Self::Error>

Performs the conversion.

impl<const N: usize> TryFrom<BInt<N>> for i32

type Error = TryFromIntError

The type returned in the event of a conversion error.

const fn try_from(int: BInt<N>) -> Result<i32, Self::Error>

Performs the conversion.

impl<const N: usize> TryFrom<BInt<N>> for i64

type Error = TryFromIntError

The type returned in the event of a conversion error.

const fn try_from(int: BInt<N>) -> Result<i64, Self::Error>

Performs the conversion.

impl<const N: usize> TryFrom<BInt<N>> for i8

type Error = TryFromIntError

The type returned in the event of a conversion error.

const fn try_from(int: BInt<N>) -> Result<i8, Self::Error>

Performs the conversion.

impl<const N: usize> TryFrom<BInt<N>> for isize

type Error = TryFromIntError

The type returned in the event of a conversion error.

const fn try_from(int: BInt<N>) -> Result<isize, Self::Error>

Performs the conversion.

impl<const N: usize> TryFrom<BInt<N>> for u128

type Error = TryFromIntError

The type returned in the event of a conversion error.

const fn try_from(int: BInt<N>) -> Result<u128, Self::Error>

Performs the conversion.

impl<const N: usize> TryFrom<BInt<N>> for u16

type Error = TryFromIntError

The type returned in the event of a conversion error.

const fn try_from(int: BInt<N>) -> Result<u16, Self::Error>

Performs the conversion.

impl<const N: usize> TryFrom<BInt<N>> for u32

type Error = TryFromIntError

The type returned in the event of a conversion error.

const fn try_from(int: BInt<N>) -> Result<u32, Self::Error>

Performs the conversion.

impl<const N: usize> TryFrom<BInt<N>> for u64

type Error = TryFromIntError

The type returned in the event of a conversion error.

const fn try_from(int: BInt<N>) -> Result<u64, Self::Error>

Performs the conversion.

impl<const N: usize> TryFrom<BInt<N>> for u8

type Error = TryFromIntError

The type returned in the event of a conversion error.

const fn try_from(int: BInt<N>) -> Result<u8, Self::Error>

Performs the conversion.

impl<const N: usize> TryFrom<BInt<N>> for usize

type Error = TryFromIntError

The type returned in the event of a conversion error.

const fn try_from(int: BInt<N>) -> Result<usize, Self::Error>

Performs the conversion.

impl<const N: usize> TryFrom<BUint<N>> for BInt<N>

type Error = TryFromIntError

The type returned in the event of a conversion error.

const fn try_from(u: BUint<N>) -> Result<Self, Self::Error>

Performs the conversion.

impl<const N: usize> UpperExp for BInt<N>

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

Formats the value using the given formatter.

impl<const N: usize> UpperHex for BInt<N>

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

Formats the value using the given formatter.

impl<const N: usize> WrappingAdd for BInt<N>

fn wrapping_add(&self, rhs: &Self) -> Self

Wrapping (modular) addition. Computes self + other, wrapping around at the boundary of the type.

impl<const N: usize> WrappingMul for BInt<N>

fn wrapping_mul(&self, rhs: &Self) -> Self

Wrapping (modular) multiplication. Computes self * other, wrapping around at the boundary of the type.

impl<const N: usize> WrappingNeg for BInt<N>

fn wrapping_neg(&self) -> Self

Wrapping (modular) negation. Computes -self, wrapping around at the boundary of the type.

impl<const N: usize> WrappingShl for BInt<N>

fn wrapping_shl(&self, rhs: u32) -> Self

Panic-free bitwise shift-left; yields self << mask(rhs), where mask removes any high order bits of rhs that would cause the shift to exceed the bitwidth of the type.

impl<const N: usize> WrappingShr for BInt<N>

fn wrapping_shr(&self, rhs: u32) -> Self

Panic-free bitwise shift-right; yields self >> mask(rhs), where mask removes any high order bits of rhs that would cause the shift to exceed the bitwidth of the type.

impl<const N: usize> WrappingSub for BInt<N>

fn wrapping_sub(&self, rhs: &Self) -> Self

Wrapping (modular) subtraction. Computes self - other, wrapping around at the boundary of the type.

impl<const N: usize> Zero for BInt<N>

fn zero() -> Self

Returns the additive identity element of Self, 0.

fn is_zero(&self) -> bool

Returns true if self is equal to the additive identity.

fn set_zero(&mut self)

Sets self to the additive identity element of Self, 0.

impl<const N: usize> Copy for BInt<N>

impl<const N: usize> Eq for BInt<N>