229 lines
8.6 KiB
Markdown
229 lines
8.6 KiB
Markdown
<!-- Copyright © 2018–2019 Trevor Spiteri -->
|
||
|
||
<!-- Copying and distribution of this file, with or without
|
||
modification, are permitted in any medium without royalty provided the
|
||
copyright notice and this notice are preserved. This file is offered
|
||
as-is, without any warranty. -->
|
||
|
||
Version 0.4.5 (2019-08-30)
|
||
==========================
|
||
|
||
* Bug fix: display of many decimal numbers was panicking in debug
|
||
mode or including a leading zero in release mode.
|
||
* Many methods were added to `Wrapping` for convenience, even if
|
||
they do not involve wrapping.
|
||
|
||
Version 0.4.4 (2019-08-24)
|
||
==========================
|
||
|
||
* Bug fix: rounding could produce bad output for `Binary`, `Octal`,
|
||
`LowerHex` and `UpperHex`.
|
||
* The following methods are now `const` functions:
|
||
`is_power_of_two`, `abs`, `wrapping_abs`, `overflowing_abs`
|
||
* The method `round_to_zero` was added.
|
||
* The method `round_ties_to_even` and its checked versions were
|
||
added.
|
||
|
||
Version 0.4.3 (2019-08-20)
|
||
==========================
|
||
|
||
* The *fixed* crate now requires rustc version 1.34.0 or later.
|
||
* The precision argument is no longer ignored when formatting
|
||
fixed-point numbers; precision should now be handled the same as
|
||
for primitive floating-point numbers in the standard library.
|
||
* Parsing strings now rounds to the nearest with ties rounded to
|
||
even.
|
||
* Checked versions of string parsing methods are now available as
|
||
inherent methods to all fixed-point numbers, and as methods in the
|
||
`Fixed` trait.
|
||
* `Wrapping` now has methods for parsing with wrapping, including
|
||
an implementation of `FromStr`.
|
||
* The following methods are now `const` functions:
|
||
* `min_value`, `max_value`, `from_bits`, `to_bits`
|
||
* `count_ones`, `count_zeros`, `leading_zeros`, `trailing_zeros`
|
||
`rotate_left`, `rotate_right`
|
||
* `wrapping_neg`, `wrapping_add`, `wrapping_sub`,
|
||
`wrapping_mul_int`, `wrapping_shl`, `wrapping_shr`
|
||
* `overflowing_neg`, `overflowing_add`, `overflowing_sub`,
|
||
`overflowing_mul_int`, `overflowing_shl`, `overflowing_shr`
|
||
* `is_positive`, `is_negative`
|
||
* The associated constants `INT_NBITS` and `FRAC_NBITS` were added.
|
||
* The reexports in the `frac` module and the `LeEqU*` traits were
|
||
moved into the new `types::extra` module.
|
||
|
||
Version 0.4.2 (2019-08-16)
|
||
==========================
|
||
|
||
* The new methods [`from_num`] and [`to_num`] together with their
|
||
checked versions were added to all fixed-point numbers.
|
||
* The methods `from_fixed`, `to_fixed`, `from_int`, `to_int`,
|
||
`from_float`, and `to_float`, and their checked versions, were
|
||
deprecated.
|
||
* The new method [`from_num`][`Wrapping::from_num`] was added to the
|
||
[`Wrapping`] wrapper.
|
||
* Bug fix: parsing of decimal fractions was fixed to give correctly
|
||
rounded results for long decimal fraction strings, for example
|
||
with four fractional bits, 0.96874999… (just below 31⁄32) and
|
||
0.96875 (31⁄32) are now parsed correctly as 0.9375 (15⁄16) and 1.0.
|
||
|
||
Version 0.4.1 (2019-08-12)
|
||
==========================
|
||
|
||
* All fixed-point types now implement `FromStr`.
|
||
* The methods `from_str_binary`, `from_str_octal` and `from_str_hex`
|
||
were added.
|
||
|
||
Version 0.4.0 (2019-08-08)
|
||
==========================
|
||
|
||
* The *fixed* crate now requires rustc version 1.31.0 or later.
|
||
* The `traits` module was added, with its traits `Fixed`,
|
||
`FixedSigned`, `FixedUnsigned`, `FromFixed`, `ToFixed`,
|
||
`LossyFrom` and `LossyInto`.
|
||
* The `saturating_neg` method was added to all fixed-point numbers,
|
||
and the `saturating_abs` method was added to signed fixed-point
|
||
numbers.
|
||
* The `consts` module was added.
|
||
* The `signum` method now wraps instead of panics in release mode.
|
||
|
||
Incompatible changes
|
||
--------------------
|
||
|
||
* The sealed traits `Int` and `Float` now have no provided methods;
|
||
the methods in the old implementation are now provided by
|
||
`FromFixed` and `ToFixed`.
|
||
* Deprecated methods were removed.
|
||
|
||
Contributors
|
||
------------
|
||
|
||
* @jean-airoldie
|
||
* @tspiteri
|
||
|
||
Version 0.3.3 (2019-06-27)
|
||
==========================
|
||
|
||
* Conversions to/from `isize` and `usize` were added.
|
||
|
||
Version 0.3.2 (2019-02-27)
|
||
==========================
|
||
|
||
* The `Wrapping` wrapper was added.
|
||
|
||
Version 0.3.1 (2019-02-07)
|
||
==========================
|
||
|
||
* Reimplement `From<bool>` for all fixed-point types which can
|
||
represent the integer 1. This was inadvertently removed in 0.3.0.
|
||
|
||
Version 0.3.0 (2019-02-03)
|
||
==========================
|
||
|
||
* Incompatible change: the return type of `to_int` is now generic.
|
||
* Incompatible change: the `Int` trait implementation for `bool` was
|
||
removed.
|
||
* The new method `to_fixed` was added.
|
||
* The new methods `checked_to_fixed`, `checked_to_int`,
|
||
`saturating_to_fixed`, `saturating_to_int`, `wrapping_to_fixed`,
|
||
`wrapping_to_int`, `overflowing_to_fixed` and `overflowing_to_int`
|
||
were added.
|
||
* The methods `from_fixed`, `to_fixed`, `checked_from_fixed`,
|
||
`checked_to_fixed`, `saturating_from_fixed`,
|
||
`saturating_to_fixed`, `wrapping_from_fixed`, `wrapping_to_fixed`,
|
||
`overflowing_from_fixed` and `overflowing_to_fixed` were added to
|
||
the `Int` trait.
|
||
* The methods `from_fixed`, `to_fixed`, `checked_to_fixed`,
|
||
`saturating_to_fixed`, `wrapping_to_fixed` and
|
||
`overflowing_to_fixed` were added to the `Float` trait.
|
||
* `PartialEq` and `PartialCmp` are now implemented for all
|
||
combinations of fixed-point numbers and primitive integers.
|
||
* The methods `int_bits` and `frac_bits` were deprecated and
|
||
replaced by the methods `int_nbits` and `frac_nbits`.
|
||
|
||
Version 0.2.1 (2019-01-29)
|
||
==========================
|
||
|
||
* Bug fix: the `from_fixed` and `from_int` methods (and their
|
||
checked counterparts) could return wrong values for negative
|
||
values.
|
||
* Bug fix: display was using one fractional digit less than
|
||
required, thus yielding the same output for diffent fixed-point
|
||
numbers.
|
||
|
||
Version 0.2.0 (2019-01-29)
|
||
==========================
|
||
|
||
* Incompatible change: The method `from_int` was change to accept a
|
||
generic parameter.
|
||
* The new methods `from_fixed`, `checked_from_fixed`,
|
||
`saturating_from_fixed`, `wrapping_from_fixed` and
|
||
`overflowing_from_fixed` were added.
|
||
* The new methods `checked_from_int`, `saturating_from_int`,
|
||
`wrapping_from_int` and `overflowing_from_int` were added.
|
||
* The new methods `from_float`, `checked_from_float`,
|
||
`saturating_from_float`, `wrapping_from_float` and
|
||
`overflowing_from_float` were added.
|
||
* The new method `to_float` was added.
|
||
* The methods `from_f16`, `from_f32`, `from_f64`, `to_f16`, `to_f32`
|
||
and `to_f64` were deprecated.
|
||
* The `to_int` method was fixed to truncate fractional bits as
|
||
documented for negative values.
|
||
* The new methods `ceil`, `floor`, `round`, `checked_ceil`,
|
||
`checked_floor`, `checked_round`, `saturating_ceil`,
|
||
`saturating_floor`, `saturating_round`, `wrapping_ceil`,
|
||
`wrapping_floor`, `wrapping_round`, `overflowing_ceil`,
|
||
`overflowing_floor` and `overflowing_round` were added.
|
||
* The methods `to_int_ceil`, `to_int_floor` and `to_int_round` were
|
||
deprecated.
|
||
|
||
Version 0.1.6 (2019-01-27)
|
||
==========================
|
||
|
||
* Optional serde support was added.
|
||
|
||
Version 0.1.5 (2019-01-26)
|
||
==========================
|
||
|
||
* Lossless infallible conversions between fixed-point numbers and
|
||
numeric primitives are now supported using `From` and `Into`.
|
||
* A new module `types` is available with aliases for all supported
|
||
fixed-point numbers.
|
||
|
||
Version 0.1.4 (2018-11-29)
|
||
==========================
|
||
|
||
* Division is now implemented for `FixedI128` and `FixedU128`.
|
||
|
||
Version 0.1.3 (2018-08-23)
|
||
==========================
|
||
|
||
* The `f16` feature was added, and new methods `from_f16` and
|
||
`to_f16` were added.
|
||
|
||
Version 0.1.2 (2018-08-15)
|
||
==========================
|
||
|
||
* The crate can now be used without the standard library `std`.
|
||
* New methods `from_f32` and `from_f64` were added.
|
||
* New methods `is_positive` and `is_negative` were added to signed
|
||
fixed-point numbers.
|
||
|
||
Version 0.1.1 (2018-08-11)
|
||
==========================
|
||
|
||
* Comparisons are now supported between all fixed-point numbers with
|
||
the same underlying integer type.
|
||
* New static methods `int_bits` and `frac_bits` were added.
|
||
* New methods `from_int`, `to_int`, `to_int_ceil`, `to_int_floor`
|
||
and `to_int_round` were added.
|
||
* New methods `int` and `frac` were added.
|
||
* Support for multiplication and division by integers was added.
|
||
|
||
Version 0.1.0 (2018-08-10)
|
||
==========================
|
||
|
||
* `Unsigned` constants provided by the *typenum* crate are now used
|
||
for the number of fractional bits.
|
||
* Many methods and trait implementations available for primitive
|
||
integers are now also supported by the fixed-point numbers.
|