num-bigfloat
| Crates.io | num-bigfloat |
| lib.rs | num-bigfloat |
| version | 1.7.1 |
| source | src |
| created_at | 2022-05-29 12:49:59.18204 |
| updated_at | 2024-03-09 17:08:28.222225 |
| description | Increased precision floating point numbers implemented purely in Rust. |
| homepage | |
| repository | https://github.com/stencillogic/num-bigfloat |
| max_upload_size | |
| id | 596495 |
| size | 4,070,920 |
(stencillogic)
documentation
README
Increased precision floating point numbers implemented purely in Rust.
Arbitrary precision numbers
A fork of the library is available that implements floating-point numbers of arbitrary precision: astro-float. The new library uses more elaborate algorithms, has higher accuracy and better test coverage.
Rationale
There are several notable implementations of numbers with increased precision for Rust. Among the libraries, one can recall num-bigint, rust_decimal.
While these libraries are great in many ways, they don't allow you to perform operations on numbers while still providing fairly high precision.
There are also wrapper libraries, like rug, that depend on MPFR for implementing arbitrary precision floating point numbers.
This library is written in pure Rust, provides more precision than f32, f64, and some other data types with increased precision.
Number characteristics
Number has fixed-size mantissa and exponent.
| Name | Value |
|---|---|
| Base | 10 |
| Decimal positions in mantissa | 40 |
| Exponent minimum value | -128 |
| Exponent maximum value | 127 |
no_std
Library can be used without the standard Rust library. This can be achieved by turning off std feature.
Performance
Benchmark for num-bigfloat, rug(MPFR), and astro-float can be found here: bigfloat-bench.
Other features
The library depends on rand which is used by BigFloat::random_normal. This dependecy can be excluded by turning off the rand feature. rand feature requires std feature.
The library depends on serde which is also optional and can be eliminated by turning off the serde feature.
In addition, the library implements num-traits. Dependency on num-traits can be excluded by turning off num-traits feature.