--- old/src/java.base/share/classes/java/lang/Character.java 2018-03-01 18:43:31.092109235 -0800 +++ new/src/java.base/share/classes/java/lang/Character.java 2018-03-01 18:43:30.888105493 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2002, 2017, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2002, 2018, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -7568,6 +7568,11 @@ * specified {@code char}. The result is a string of length * 1 consisting solely of the specified {@code char}. * + * @apiNote This method cannot handle supplementary characters. To support + * all Unicode characters, including supplementary characters, use + * the {@link #toString(int)} method. + * * @param c the {@code char} to be converted * @return the string representation of the specified {@code char} * @since 1.4 @@ -7577,6 +7582,22 @@ } /** + * Returns a {@code String} object representing the + * specified character (Unicode code point). The result is a string of + * length 1 or 2, consisting solely of the specified {@code codePoint}. + * + * @param codePoint the {@code codePoint} to be converted + * @return the string representation of the specified {@code codePoint} + * @exception IllegalArgumentException if the specified + * {@code codePoint} is not a {@linkplain #isValidCodePoint + * valid Unicode code point}. + * @since 11 + */ + public static String toString(int codePoint) { + return String.valueOfCodePoint(codePoint); + } + + /** * Determines whether the specified code point is a valid * * Unicode code point value.