Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8266578

Disambiguate BigDecimal description of scale

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Resolved
    • Priority: P4
    • Resolution: Fixed
    • Affects Version/s: 17
    • Fix Version/s: 18
    • Component/s: core-libs
    • Labels:
    • Subcomponent:
    • Resolved In Build:
      b06

      Description

      The API Docs for BigDecimal introduce the meaning of scale. The current verbiage can be misleading when presenting the meaning of a scale value that's negative.

      The ambiguity is in this sentence:

          If negative, the unscaled value of the number is ...

      which could be replaced with the slightly more verbose:

          If the scale is negative, the unscaled value of the number is ...

      To keep symmetry, also revise the positive case from:

          If zero or positive, the scale is the number of digits ...

      to:

          If the scale is zero or positive, the scale is the number of digits ...

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              bpb Brian Burkhalter
              Reporter:
              bpb Brian Burkhalter
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved: