#mathematics #numerics #bignum


Big integer implementation for Rust

13 releases

0.2.0 May 25, 2018
0.1.43 Feb 9, 2018
0.1.41 Dec 1, 2017
0.1.40 Jul 15, 2017
0.1.33 Jul 12, 2016

#4 in Algorithms

Download history 9638/week @ 2018-09-19 10767/week @ 2018-09-26 11951/week @ 2018-10-03 12303/week @ 2018-10-10 12868/week @ 2018-10-17 11549/week @ 2018-10-24 13360/week @ 2018-10-31 14074/week @ 2018-11-07 16166/week @ 2018-11-14 15236/week @ 2018-11-21 13401/week @ 2018-11-28 15230/week @ 2018-12-05 14489/week @ 2018-12-12

42,782 downloads per month
Used in 165 crates (68 directly)




crate documentation minimum rustc 1.15 Travis status

Big integer types for Rust, BigInt and BigUint.


Add this to your Cargo.toml:

num-bigint = "0.2"

and this to your crate root:

extern crate num_bigint;


The std crate feature is mandatory and enabled by default. If you depend on num-bigint with default-features = false, you must manually enable the std feature yourself. In the future, we hope to support #![no_std] with the alloc crate when std is not enabled.

Implementations for i128 and u128 are only available with Rust 1.26 and later. The build script automatically detects this, but you can make it mandatory by enabling the i128 crate feature.


Release notes are available in RELEASES.md.


The num-bigint crate is tested for rustc 1.15 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.

Crate License Min rustc Implementation
num-bigint MIT/Apache-2.0 1.15 pure rust
ramp Apache-2.0 nightly rust and inline assembly
rug LGPL-3.0+ 1.18 bundles GMP via gmp-mpfr-sys
rust-gmp MIT stable? links to GMP
apint MIT/Apache-2.0 1.26 pure rust (unfinished)