On Fri, 4 Dec 2020 22:13:21 GMT, Roger Riggs <[email protected]> wrote:
>> src/java.base/share/classes/java/util/HexFormat.java line 936:
>>
>>> 934: * if any of the characters is not a hexadecimal character
>>> 935: */
>>> 936: public int fromHexDigits(CharSequence string) {
>>
>> I recommend this group of methods include an apinote explaining the
>> differences in behavior of compared to parseInt(s, 16) and
>> parseUnsignedInt(s, 16).
>
> Will add:
> * @apiNote
> * {@link Integer#parseInt(String, int) Integer.parseInt(s, 16)} and
> * {@link Integer#parseUnsignedInt(String, int)
> Integer.pareUnsignedInt(s, 16)}
> * are similar but allow all Unicode hexadecimal digits allowed by
> * {@link Character#digit(char, int) Character.digit(ch, 16)}.
> * {@code HexFormat} uses only Latin1 hexadecimal characters "0-9, "A-F",
> and "a-f".
> * {@link Integer#parseInt(String, int)} can parse signed hexadecimal
> strings.
> And similar text for Long#parseLong and Long.parseUnsignedLong
Okay; however, I suggest saying more on the signed/unsigned behavior.
-------------
PR: https://git.openjdk.java.net/jdk/pull/482
