#floating-point #float #no-std #numerical-methods #numeric

no-std ieee754

Low-level manipulations of IEEE754 floating-point numbers

9 releases

Uses old Rust 2015

0.3.0-alpha.2 Dec 20, 2020
0.2.6 Jan 13, 2019
0.2.2 May 17, 2017
0.2.1 Nov 19, 2015
0.1.1 May 12, 2015

#238 in Math

Download history 21391/week @ 2024-01-02 22669/week @ 2024-01-09 22751/week @ 2024-01-16 22710/week @ 2024-01-23 19638/week @ 2024-01-30 22144/week @ 2024-02-06 20414/week @ 2024-02-13 23495/week @ 2024-02-20 21849/week @ 2024-02-27 24036/week @ 2024-03-05 22333/week @ 2024-03-12 26117/week @ 2024-03-19 24438/week @ 2024-03-26 29182/week @ 2024-04-02 31834/week @ 2024-04-09 27943/week @ 2024-04-16

116,865 downloads per month
Used in 213 crates (17 directly)

MIT/Apache

75KB
1K SLoC

ieee754

Build Status codecov

Low-level manipulations of IEEE754 floating-point numbers.

This library includes:

  • no_std support by default,
  • ulp computation (units in the last place, representing the resolution of a float),
  • miscellaneous functions like nextafter (next and prev), copysign (copy_sign), abs, sign,
  • the IEEE-754 totalOrder predicate for doing Ord::cmp-like comparisons on floats,
  • an iterator over every floating point value in a range,
  • a parallel iterator over every floating point value in a range (optional: activate with the rayon feature),
  • relative error computation.

Documentation, crates.io.


lib.rs:

Low-level manipulations of IEEE754 floating-point numbers.

Installation

Add this to your Cargo.toml:

[dependencies]
ieee754 = "0.2"

To enable rayon parallel iteration, activate the optional rayon feature:

[dependencies]
ieee754 = { version = "0.2", features = ["rayon"] }

Examples

use ieee754::Ieee754;

// there are 840 single-precision floats between 1.0 and 1.0001
// (inclusive).
assert_eq!(1_f32.upto(1.0001).count(), 840);

If rayon is enabled, this can be performed in parallel:

extern crate ieee754;
extern crate rayon;

use ieee754::Ieee754;
use rayon::prelude::*;

// there are 840 single-precision floats between 1.0 and 1.0001
// (inclusive).
assert_eq!(1_f32.upto(1.0001).into_par_iter().count(), 840);

Dependencies

~0–285KB