8262927: Explicitly state fields examined for BigDecimal.hashCode

Reviewed-by: bpb
openjdk · Mar 3, 2021 · 2848938 · 2848938 · openjdk-notifier · Mar 3, 2021
1 parent b397472
commit 2848938
Showing 1 changed file with 7 additions and 2 deletions.
diff --git a/src/java.base/share/classes/java/math/BigDecimal.java b/src/java.base/share/classes/java/math/BigDecimal.java
@@ -3215,8 +3215,13 @@ public BigDecimal max(BigDecimal val) {
     // Hash Function
 
     /**
-     * Returns the hash code for this {@code BigDecimal}.  Note that
-     * two {@code BigDecimal} objects that are numerically equal but
+     * Returns the hash code for this {@code BigDecimal}.
+     * The hash code is computed as a function of the {@linkplain
+     * unscaledValue() unscaled value} and the {@linkplain scale()
+     * scale} of this {@code BigDecimal}.
+     *
+     * @apiNote
+     * Two {@code BigDecimal} objects that are numerically equal but
      * differ in scale (like 2.0 and 2.00) will generally <em>not</em>
      * have the same hash code.
      *