Contributors: @CryZe
- A new optional
libm
dependency enables theFloat
andReal
traits inno_std
builds. - The new
clamp_min
andclamp_max
limit minimum and maximum values while preserving inputNAN
s. - Fixed a panic in floating point
from_str_radix
on invalid signs. - Miscellaneous documentation updates.
Contributors: @cuviper, @dingelish, @HeroicKatora, @jturner314, @ocstl, @Shnatsel, @termoshtt, @waywardmonkeys, @yoanlcq
Contributors: @cuviper
- Documented when
CheckedShl
andCheckedShr
returnNone
. - The new
Zero::set_zero
andOne::set_one
will set values to their identities in place, possibly optimized better than direct assignment. - Documented general features and intentions of
PrimInt
.
Contributors: @cuviper, @dvdhrm, @ignatenkobrain, @lcnr, @samueltardieu
- Documented that
pow(0, 0)
returns1
. Mathematically, this is not strictly defined, but the current behavior is a pragmatic choice that has precedent in Rustcore
for the primitives and in many other languages. - The new
WrappingShl
andWrappingShr
traits will wrap the shift count if it exceeds the bit size of the type.
Contributors: @cuviper, @edmccard, @meltinglava
- Documentation for
mul_add
now clarifies that it's not always faster. - The default methods in
FromPrimitive
andToPrimitive
are more robust.
Contributors: @cuviper, @frewsxcv
- Support for 128-bit integers is now automatically detected and enabled.
Setting the
i128
crate feature now causes the build script to panic if such support is not detected.
Contributors: @cuviper
- The new
CheckedNeg
andCheckedRem
traits perform checkedNeg
andRem
, returningSome(output)
orNone
on overflow. - The
no_std
implementation ofFloatCore::to_degrees
forf32
now uses a constant for greater accuracy, mirroring rust#47919. (Withstd
it just calls the inherentf32::to_degrees
in the standard library.) - The new
MulAdd
andMulAddAssign
traits perform a fused multiply- add. For integer types this is just a convenience, but for floating point types this produces a more accurate result than the separate operations. - All applicable traits are now implemented for 128-bit integers starting
with Rust 1.26, enabled by the new
i128
crate feature. TheFromPrimitive
andToPrimitive
traits now also have corresponding 128-bit methods, which default to converting via 64-bit integers for compatibility.
Contributors: @cuviper, @LEXUGE, @regexident, @vks
- Casting from floating point to integers now returns
None
on overflow, avoiding rustc's undefined behavior. This applies to thecast
function and the traitsNumCast
,FromPrimitive
, andToPrimitive
.
Contributors: @apopiak, @cuviper, @dbarella
- The new
FloatCore
trait offers a subset ofFloat
for#![no_std]
use. This includes everything except the transcendental functions and FMA. - The new
Inv
trait returns the multiplicative inverse, or reciprocal. - The new
Pow
trait performs exponentiation, much like the existingpow
function, but with generic exponent types. - The new
One::is_one
method tests if a value equals 1. Implementers should override this method if there's a more efficient way to check for 1, rather than comparing with a temporaryone()
.
Contributors: @clarcharr, @cuviper, @vks
- breaking change: There is now a
std
feature, enabled by default, along with the implication that building without this feature makes this a#![no_std]
crate.- The
Float
andReal
traits are only available whenstd
is enabled. - Otherwise, the API is unchanged, and num-traits 0.1.43 now re-exports its items from num-traits 0.2 for compatibility (the semver-trick).
- The
Contributors: @cuviper, @termoshtt, @vks
- All items are now re-exported from num-traits 0.2 for compatibility.
- num-traits now has its own source repository at rust-num/num-traits.
ParseFloatError
now implementsDisplay
.- The new
AsPrimitive
trait implements generic casting with theas
operator. - The new
CheckedShl
andCheckedShr
traits implement generic support for thechecked_shl
andchecked_shr
methods on primitive integers. - The new
Real
trait offers a subset ofFloat
functionality that may be applicable to more types, with a blanket implementation for all existingT: Float
types.
Thanks to @cuviper, @Enet4, @fabianschuiki, @svartalf, and @yoanlcq for their contributions!
No prior release notes were kept. Thanks all the same to the many contributors that have made this crate what it is!