archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-27 06:45:07 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8294539: Augment discussion of equivalence relations on floating-point values

Browse source 
Reviewed-by: psandoz, smarks
This commit is contained in:
Joe Darcy 2022-10-05 00:18:55 +00:00
parent b2e86a6209
commit 1dafbe3f94
2 changed files with 71 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

7
src/java.base/share/classes/java/math/BigDecimal.java
View file

@ -3087,6 +3087,10 @@ public class BigDecimal extends Number implements Comparable<BigDecimal> {
* @apiNote
* Note: this class has a natural ordering that is inconsistent with equals.
* The behavior of comparing the result of this method for
* equality to 0 is analogous to checking the <a
* href="{@docRoot}/java.base/java/lang/Double.html#fpNumericalEq">numerical
* equality</a> of {@code double} values.
*
* @param val {@code BigDecimal} to which this {@code BigDecimal} is
* to be compared.
@ -3179,6 +3183,9 @@ public class BigDecimal extends Number implements Comparable<BigDecimal> {
* HALF_UP)} which evaluates to 0.7 and <br>
* {@code new BigDecimal("2.00").divide(BigDecimal.valueOf(3),
* HALF_UP)} which evaluates to 0.67.
* The behavior of this method is analogous to checking the <a
* href="{@docRoot}/java.base/java/lang/Double.html#repEquivalence">representation
* equivalence</a> of {@code double} values.
*
* @param x {@code Object} to which this {@code BigDecimal} is
* to be compared.