RFR: 8251989: Hex formatting and parsing utility [v16]

[Daniel Fuchs]

On Wed, 2 Dec 2020 14:55:18 GMT, Roger Riggs <rriggs at openjdk.org> wrote:

>> java.util.HexFormat utility:
>> 
>>  - Format and parse hexadecimal strings, with parameters for delimiter, prefix, suffix and upper/lowercase
>>  - Static factories and builder methods to create HexFormat copies with modified parameters.
>>  - Consistent naming of methods for conversion of byte arrays to formatted strings and back: formatHex and parseHex
>>  - Consistent naming of methods for conversion of primitive types: toHexDigits... and fromHexDigits...
>>  - Prefix and suffixes now apply to each formatted value, not the string as a whole
>>  - Using java.util.Appendable as a target for buffered conversions so output to Writers and PrintStreams
>>    like System.out are supported in addition to StringBuilder. (IOExceptions are converted to unchecked exceptions)
>>  - Immutable and thread safe, a "value-based" class
>> 
>> See the [HexFormat javadoc](http://cr.openjdk.java.net/~rriggs/8251989-hex-formatter/java.base/java/util/HexFormat.html) for details.
>> 
>> Review comments and suggestions welcome.
>
> Roger Riggs has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Clarify that the fromHexDigit method does not use the prefix, suffix, delimiter, or uppercase parameter.

src/java.base/share/classes/java/util/HexFormat.java line 675:

> 673:      * The hexadecimal characters are appended in one or more calls to the
> 674:      * {@link Appendable} methods.
> 675:      *

For parity with the method `public String toHexDigits(byte value)` above I would suggest to add the text

     * The delimiter, prefix and suffix are not used.

here too.

-------------

PR: https://git.openjdk.java.net/jdk/pull/482