RFR: 8251989: Hex formatting and parsing utility [v13]
Roger Riggs
rriggs at openjdk.java.net
Tue Dec 1 22:20:16 UTC 2020
> 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:
Review comment updates:
- misc javadoc markup fixes.
- added checking of byte array sizes to generate useful exceptions if the arrays would be too large.
- Small implementation cleanups
-------------
Changes:
- all: https://git.openjdk.java.net/jdk/pull/482/files
- new: https://git.openjdk.java.net/jdk/pull/482/files/a1ce9d7c..bbcb2135
Webrevs:
- full: https://webrevs.openjdk.java.net/?repo=jdk&pr=482&range=12
- incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=482&range=11-12
Stats: 63 lines in 4 files changed: 35 ins; 1 del; 27 mod
Patch: https://git.openjdk.java.net/jdk/pull/482.diff
Fetch: git fetch https://git.openjdk.java.net/jdk pull/482/head:pull/482
PR: https://git.openjdk.java.net/jdk/pull/482
More information about the core-libs-dev
mailing list