25 releases

0.9.5 Nov 29, 2022
0.9.3 Feb 4, 2022
0.9.1 Jun 30, 2021
0.9.0 Jan 5, 2021
0.1.0 Dec 29, 2017

#8 in Data structures

Download history 93087/week @ 2022-10-14 91468/week @ 2022-10-21 94290/week @ 2022-10-28 110630/week @ 2022-11-04 97572/week @ 2022-11-11 96914/week @ 2022-11-18 99059/week @ 2022-11-25 109722/week @ 2022-12-02 108939/week @ 2022-12-09 97516/week @ 2022-12-16 57470/week @ 2022-12-23 70271/week @ 2022-12-30 102996/week @ 2023-01-06 97356/week @ 2023-01-13 101268/week @ 2023-01-20 99029/week @ 2023-01-27

416,264 downloads per month
Used in 1,375 crates (96 directly)

MIT/Apache

52KB
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–305KB