#decimal-number #decimal #big-float #bignum #increase

no-std num-bigfloat

Increased precision floating point numbers implemented purely in Rust

19 releases (stable)

1.7.1 Mar 9, 2024
1.7.0 Sep 10, 2023
1.6.3 Aug 15, 2023
1.6.2 Feb 3, 2023
0.1.6 Jun 19, 2022

#53 in Math

Download history 538/week @ 2024-08-02 501/week @ 2024-08-09 546/week @ 2024-08-16 591/week @ 2024-08-23 624/week @ 2024-08-30 660/week @ 2024-09-06 680/week @ 2024-09-13 920/week @ 2024-09-20 877/week @ 2024-09-27 917/week @ 2024-10-04 762/week @ 2024-10-11 801/week @ 2024-10-18 720/week @ 2024-10-25 787/week @ 2024-11-01 586/week @ 2024-11-08 538/week @ 2024-11-15

2,789 downloads per month
Used in 10 crates

MIT license

4MB
157K SLoC

Tests Minimum rustc version

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.

Dependencies