4 releases

0.0.7 Oct 15, 2023
0.0.6 Oct 14, 2023

#1542 in Math

Download history 8/week @ 2024-11-13 20/week @ 2024-11-20 37/week @ 2024-11-27 39/week @ 2024-12-04 44/week @ 2024-12-11 15/week @ 2024-12-18 7/week @ 2025-01-01 15/week @ 2025-01-08 23/week @ 2025-01-15 27/week @ 2025-01-22 13/week @ 2025-01-29 35/week @ 2025-02-05 24/week @ 2025-02-12 14/week @ 2025-02-19 13/week @ 2025-02-26

88 downloads per month
Used in 7 crates (4 directly)

MIT license

23KB
520 lines

umath: ffast-math, for rust.

MSRV DOCS

Want to make your math faster? *t&c apply

Want to order a float?

You can do all of that, with umath!

use umath::FFloat;
// wrap a non NAN and non INF f32/f64 (we will also *never* make this number nan).
let mut f = unsafe { FFloat::new(4.0f32) };
f *= 3; // multiply by 3
// this check will be removed by the optimizer!
assert!(!f.is_nan());
# use std::collections::BinaryHeap;
// use a ORD type! this is allowed, as FFloat is not allowed to be NAN | INF.
let mut b = BinaryHeap::new();
b.push(unsafe { FFloat::new(2.0) });
b.push(unsafe { FFloat::new(1.0) });
b.push(unsafe { FFloat::new(3.0) });
b.push(f);
assert_eq!(b.pop(), Some(unsafe { FFloat::new(24.0) }));

A note on safety

When you make your first FFLoat, you must promise that you will never create a NAN | INF FFLoat. Hence, *f = NAN is (delayed) UB.

Nightlyness

umath is nightly because it makes use of core intrinsics, like fadd_fast(), which require the core_intrinsics feature to use.

No runtime deps