Google Git
Sign in
android / platform / external / rust / crates / num-bigint / c874acea0d70a778e74b0f37f94b05ea333c18bf
commitc874acea0d70a778e74b0f37f94b05ea333c18bf[log] [tgz]
authorAndy Quan <[email protected]>Fri Jun 02 14:50:00 2023 -0700
committerAndy Quan <[email protected]>Fri Jun 02 14:50:00 2023 -0700
tree8efd4931d7f25714ad4b5334427658b52568dd9f
parentd4d596e67453e0ec992f3a074ef1211b03f2be64 [diff]
parentab88884299419e63a158f22a80015710387d68f0 [diff]
DO NOT MERGE - Merge tm-qpr3-release TQ3A.230605.010 into tm-platform-merge

Bug: 279962103
Change-Id: I77603262eb3c952b4f01f3e355c33dad503d943e
tree: 8efd4931d7f25714ad4b5334427658b52568dd9f
  1. benches/
  2. out/
  3. patches/
  4. src/
  5. tests/
  6. LICENSE ⇨ LICENSE-APACHE
  7. .cargo_vcs_info.json
  8. .gitignore
  9. Android.bp
  10. build.rs
  11. Cargo.toml
  12. cargo2android.json
  13. LICENSE-APACHE
  14. LICENSE-MIT
  15. METADATA
  16. MODULE_LICENSE_APACHE2
  17. OWNERS
  18. README.md
  19. RELEASES.md
  20. TEST_MAPPING
README.md

num-bigint

crate documentation minimum rustc 1.31 build status

Big integer types for Rust, BigInt and BigUint.

Usage

Add this to your Cargo.toml:

[dependencies]
num-bigint = "0.4"

Features

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.

Releases

Release notes are available in RELEASES.md.

Compatibility

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

Alternatives

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)

License

Licensed under either of

at your option.

Contribution

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.