JDK 11 RFR of JDK-8196995: java.lang.Character should not state UTF-16 encoding is used for strings
joe darcy
joe.darcy at oracle.com
Wed Feb 7 22:12:37 UTC 2018
Hello,
Text in java.lang.Character states a UTF-16 character encoding is used
for java.lang.String. While was true for many years, it is not
necessarily true and not true in practice as of JDK 9 due to the
improvements from JEP 254: Compact Strings.
The statement about the encoding should be corrected.
Please review the patch below which does this. (I've formatted the patch
so that the change is text is made clear; I'll re-flow the paragraph
before pushing.
Thanks,
-Joe
diff -r 0b1138ce244f src/java.base/share/classes/java/lang/Character.java
--- a/src/java.base/share/classes/java/lang/Character.java Tue Feb 06
10:17:31 2018 -0800
+++ b/src/java.base/share/classes/java/lang/Character.java Wed Feb 07
11:38:06 2018 -0800
@@ -75,7 +75,7 @@
* <a id="supplementary">Characters</a> whose code points are greater
* than U+FFFF are called <em>supplementary character</em>s. The Java
* platform uses the UTF-16 representation in {@code char} arrays and
- * in the {@code String} and {@code StringBuffer} classes. In
+ * may use it elsewhere. In
* this representation, supplementary characters are represented as a pair
* of {@code char} values, the first from the <em>high-surrogates</em>
* range, (\uD800-\uDBFF), the second from the
More information about the core-libs-dev
mailing list