src/java.base/share/classes/java/lang/Character.java

rev 49124 : imported patch 4993841

*** 1,7 ****
  /*
!  * Copyright (c) 2002, 2017, 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
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
--- 1,7 ----
  /*
!  * 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
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
*** 7566,7584 ****
--- 7566,7605 ----
      /**
       * Returns a {@code String} object representing the
       * specified {@code char}.  The result is a string of length
       * 1 consisting solely of the specified {@code char}.
       *
+      * @apiNote This method cannot handle <a
+      * href="#supplementary"> supplementary characters</a>. 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
       */
      public static String toString(char c) {
          return String.valueOf(c);
      }
  
      /**
+      * 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
       * <a href="http://www.unicode.org/glossary/#code_point">
       * Unicode code point value</a>.
       *
       * @param  codePoint the Unicode code point to be tested