8 releases (4 stable)

1.1.0 Jul 25, 2023
1.0.2 Nov 1, 2022
1.0.1 Oct 24, 2022
1.0.0 Jun 4, 2022
0.1.1 May 15, 2022

#1141 in Math

Download history 11582/week @ 2023-10-29 11142/week @ 2023-11-05 12885/week @ 2023-11-12 10371/week @ 2023-11-19 12674/week @ 2023-11-26 14220/week @ 2023-12-03 14376/week @ 2023-12-10 17050/week @ 2023-12-17 14090/week @ 2023-12-24 20753/week @ 2023-12-31 31579/week @ 2024-01-07 38667/week @ 2024-01-14 39783/week @ 2024-01-21 39960/week @ 2024-01-28 38478/week @ 2024-02-04 38214/week @ 2024-02-11

158,804 downloads per month
Used in 95 crates (2 directly)

MIT license

13KB
210 lines

The uint! macro for Uint and Bits literals

Within the uint! macro arguments, you can write Uint and Bits literals using the same syntax as Rust integer literals, but using a capital U or B suffix respectively. Note that there is ambiguity for hexadecimals with a B suffix, to lessen the impact an underscore is required in this case.

To use it simply import it in scope:

use ruint::uint;

Now constants can be created in decimal, hex, binary and even octal:

# use ruint::uint;
let avogadro = uint!(602_214_076_000_000_000_000_000_U256);
let cow_key = uint!(0xee79b5f6e221356af78cf4c36f4f7885a11b67dfcc81c34d80249947330c0f82_U256);
let bender = uint!(0b1010011010_U10);

The uint! macro recurses through the parse tree, so the above can equivalently be written

# use ruint::uint;
uint! {
let avogadro = 602_214_076_000_000_000_000_000_U256;
let cow_key = 0xee79b5f6e221356af78cf4c36f4f7885a11b67dfcc81c34d80249947330c0f82_U256;
let bender = 0b1010011010_U10;
}

This latter form is particularly useful for lookup tables:

# use ruint::{Uint, uint};
const PRIMES: [Uint<128, 2>; 3] = uint!([
    170141183460469231731687303715884105757_U128,
    170141183460469231731687303715884105773_U128,
    170141183460469231731687303715884105793_U128,
]);

The macro will throw a compile time error if you try to create a constant that does not fit the type:

# use ruint::uint;
# uint! {
let sparta = 300_U8;
# }
error: Value too large for Uint<8>: 300
 --> src/example.rs:1:14
  |
1 | let sparta = 300_U8;
  |              ^^^^^^

References

No runtime deps