num-bigfloat

Crates.ionum-bigfloat
lib.rsnum-bigfloat
version1.7.1
sourcesrc
created_at2022-05-29 12:49:59.18204
updated_at2024-03-09 17:08:28.222225
descriptionIncreased precision floating point numbers implemented purely in Rust.
homepage
repositoryhttps://github.com/stencillogic/num-bigfloat
max_upload_size
id596495
size4,070,920
(stencillogic)

documentation

README

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.

Commit count: 132

cargo fmt