26 releases

0.10.0 Sep 11, 2024
0.9.5 Nov 29, 2022
0.9.4 Sep 20, 2022
0.9.3 Feb 4, 2022
0.1.0 Dec 29, 2017

#6 in Math

Download history 226155/week @ 2025-01-04 272999/week @ 2025-01-11 252475/week @ 2025-01-18 263973/week @ 2025-01-25 298998/week @ 2025-02-01 308948/week @ 2025-02-08 290993/week @ 2025-02-15 292839/week @ 2025-02-22 295267/week @ 2025-03-01 328328/week @ 2025-03-08 332852/week @ 2025-03-15 335582/week @ 2025-03-22 339811/week @ 2025-03-29 383258/week @ 2025-04-05 324371/week @ 2025-04-12 320909/week @ 2025-04-19

1,424,845 downloads per month
Used in 3,277 crates (153 directly)

MIT/Apache

53KB
1.5K SLoC

Uint

Description

Provides facilities to construct big unsigned integer types which use no allocations (stack-based, fixed bit length). If you want to use a predefined U128, U256 or U512 type, take a look at the primitive-types or ethereum-types crate.

The focus on the provided big unsigned integer types is performance and cross-platform availability. Support a very similar API as the built-in primitive integer types.

Usage

In your Cargo.toml paste

uint = "0.8"

Import the macro

use uint::construct_uint;

If you're using pre-edition Rust in your main file

#[macro_use]
extern crate uint;

Construct your own big unsigned integer type as follows.

// U1024 with 1024 bits consisting of 16 x 64-bit words
construct_uint! {
	pub struct U1024(16);
}

Tests

Basic tests

cargo test --release

Basic tests + property tests

cargo test --release --features=quickcheck

Benchmark tests

cargo bench

Fuzz tests

see fuzz README.md

Crate Features

  • std: Use Rust's standard library.
    • Enables byteorder/std, rustc-hex/std
    • Enabled by default.
  • quickcheck: Enable quickcheck-style property testing
    • Use with cargo test --release --features=quickcheck.
  • arbitrary: Allow for creation of an uint object from random unstructured input for use with fuzzers that use the arbitrary crate.
    • Disabled by default.

Dependencies

~155–425KB