Bug: 193829374

Clone this repo:
  1. 37a621e Make num-bigint available to product and vendor am: b04487167e by Matthew Maurer · 3 months ago main master android-u-beta-1-gpl
  2. b044871 Make num-bigint available to product and vendor by Matthew Maurer · 3 months ago
  3. ac99532 Update TEST_MAPPING am: 0c46775b9d by David Brazdil · 4 months ago
  4. 0c46775 Update TEST_MAPPING by David Brazdil · 4 months ago
  5. 250fba1 [automerger skipped] Make crate vendor available am: 0b39044a12 -s ours by Josh Wu · 8 months ago


crate documentation minimum rustc 1.31 build status

Big integer types for Rust, BigInt and BigUint.


Add this to your Cargo.toml:

num-bigint = "0.4"


The std crate feature is enabled by default, and is mandatory before Rust 1.36 and the stabilized alloc crate. If you depend on num-bigint with default-features = false, you must manually enable the std feature yourself if your compiler is not new enough.

Random Generation

num-bigint supports the generation of random big integers when the rand feature is enabled. To enable it include rand as

rand = "0.8"
num-bigint = { version = "0.4", features = ["rand"] }

Note that you must use the version of rand that num-bigint is compatible with: 0.8.


Release notes are available in RELEASES.md.


The num-bigint crate is tested for rustc 1.31 and greater.


While num-bigint strives for good performance in pure Rust code, other crates may offer better performance with different trade-offs. The following table offers a brief comparison to a few alternatives.

CrateLicenseMin rustcImplementation
num-bigintMIT/Apache-2.01.31pure rust
rampApache-2.0nightlyrust and inline assembly
rugLGPL-3.0+1.37bundles GMP via gmp-mpfr-sys
rust-gmpMITstable?links to GMP
apintMIT/Apache-2.01.26pure rust (unfinished)


Licensed under either of

at your option.


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.