Class instance representing the primitive type
@@ -518,75 +518,91 @@
public static final byte DIRECTIONALITY_POP_DIRECTIONAL_FORMAT = 18;
/**
- * The minimum value of a Unicode high-surrogate code unit in the
- * UTF-16 encoding. A high-surrogate is also known as a
- * leading-surrogate.
+ * The minimum value of a
+ *
+ * Unicode high-surrogate code unit
+ * in the UTF-16 encoding, constant '\uD800'.
+ * A high-surrogate is also known as a leading-surrogate.
*
* @since 1.5
*/
public static final char MIN_HIGH_SURROGATE = '\uD800';
/**
- * The maximum value of a Unicode high-surrogate code unit in the
- * UTF-16 encoding. A high-surrogate is also known as a
- * leading-surrogate.
+ * The maximum value of a
+ *
+ * Unicode high-surrogate code unit
+ * in the UTF-16 encoding, constant '\uDBFF'.
+ * A high-surrogate is also known as a leading-surrogate.
*
* @since 1.5
*/
public static final char MAX_HIGH_SURROGATE = '\uDBFF';
/**
- * The minimum value of a Unicode low-surrogate code unit in the
- * UTF-16 encoding. A low-surrogate is also known as a
- * trailing-surrogate.
+ * The minimum value of a
+ *
+ * Unicode low-surrogate code unit
+ * in the UTF-16 encoding, constant '\uDC00'.
+ * A low-surrogate is also known as a trailing-surrogate.
*
* @since 1.5
*/
public static final char MIN_LOW_SURROGATE = '\uDC00';
/**
- * The maximum value of a Unicode low-surrogate code unit in the
- * UTF-16 encoding. A low-surrogate is also known as a
- * trailing-surrogate.
+ * The maximum value of a
+ *
+ * Unicode low-surrogate code unit
+ * in the UTF-16 encoding, constant '\uDFFF'.
+ * A low-surrogate is also known as a trailing-surrogate.
*
* @since 1.5
*/
public static final char MAX_LOW_SURROGATE = '\uDFFF';
/**
- * The minimum value of a Unicode surrogate code unit in the UTF-16 encoding.
+ * The minimum value of a Unicode surrogate code unit in the
+ * UTF-16 encoding, constant '\uD800'.
*
* @since 1.5
*/
public static final char MIN_SURROGATE = MIN_HIGH_SURROGATE;
/**
- * The maximum value of a Unicode surrogate code unit in the UTF-16 encoding.
+ * The maximum value of a Unicode surrogate code unit in the
+ * UTF-16 encoding, constant '\uDFFF'.
*
* @since 1.5
*/
public static final char MAX_SURROGATE = MAX_LOW_SURROGATE;
/**
- * The minimum value of a supplementary code point.
+ * The minimum value of a
+ *
+ * Unicode supplementary code point, constant {@code U+10000}.
*
* @since 1.5
*/
public static final int MIN_SUPPLEMENTARY_CODE_POINT = 0x010000;
/**
- * The minimum value of a Unicode code point.
+ * The minimum value of a
+ *
+ * Unicode code point, constant {@code U+0000}.
*
* @since 1.5
*/
public static final int MIN_CODE_POINT = 0x000000;
/**
- * The maximum value of a Unicode code point.
+ * The maximum value of a
+ *
+ * Unicode code point, constant {@code U+10FFFF}.
*
* @since 1.5
*/
- public static final int MAX_CODE_POINT = 0x10ffff;
+ public static final int MAX_CODE_POINT = 0X10FFFF;
/**
@@ -2648,19 +2664,15 @@
}
/**
- * Determines whether the specified code point is a valid Unicode
- * code point value in the range of 0x0000 to
- * 0x10FFFF inclusive. This method is equivalent to
- * the expression:
- *
- * + * Determines whether the specified code point is a valid + * + * Unicode code point value. * * @param codePoint the Unicode code point to be tested - * @return- * codePoint >= 0x0000 && codePoint <= 0x10FFFF - *
true if the specified code point value
- * is a valid code point value;
- * false otherwise.
+ * @return {@code true} if the specified code point value is between
+ * {@link #MIN_CODE_POINT} and
+ * {@link #MAX_CODE_POINT} inclusive;
+ * {@code false} otherwise.
* @since 1.5
*/
public static boolean isValidCodePoint(int codePoint) {
@@ -2669,15 +2681,13 @@
/**
* Determines whether the specified character (Unicode code point)
- * is in the supplementary character range. The method call is
- * equivalent to the expression:
- * + * is in the supplementary character range. * * @param codePoint the character (Unicode code point) to be tested - * @return- * codePoint >= 0x10000 && codePoint <= 0x10FFFF - *
true if the specified character is in the Unicode
- * supplementary character range; false otherwise.
+ * @return {@code true} if the specified code point is between
+ * {@link #MIN_SUPPLEMENTARY_CODE_POINT} and
+ * {@link #MAX_CODE_POINT} inclusive;
+ * {@code false} otherwise.
* @since 1.5
*/
public static boolean isSupplementaryCodePoint(int codePoint) {
@@ -2686,56 +2696,83 @@
}
/**
- * Determines if the given char value is a
- * high-surrogate code unit (also known as leading-surrogate
- * code unit). Such values do not represent characters by
- * themselves, but are used in the representation of supplementary characters in the
- * UTF-16 encoding.
+ * Determines if the given {@code char} value is a
+ *
+ * Unicode high-surrogate code unit
+ * (also known as leading-surrogate code unit).
*
- * This method returns true if and only if
- *
- * isch >= '\uD800' && ch <= '\uDBFF' - *
true.
+ * Such values do not represent characters by themselves,
+ * but are used in the representation of
+ * supplementary characters
+ * in the UTF-16 encoding.
*
- * @param ch the char value to be tested.
- * @return true if the char value
- * is between '\uD800' and '\uDBFF' inclusive;
- * false otherwise.
- * @see java.lang.Character#isLowSurrogate(char)
- * @see Character.UnicodeBlock#of(int)
- * @since 1.5
+ * @param ch the {@code char} value to be tested.
+ * @return {@code true} if the {@code char} value is between
+ * {@link #MIN_HIGH_SURROGATE} and
+ * {@link #MAX_HIGH_SURROGATE} inclusive;
+ * {@code false} otherwise.
+ * @see #isLowSurrogate(char)
+ * @see Character.UnicodeBlock#of(int)
+ * @since 1.5
*/
public static boolean isHighSurrogate(char ch) {
return ch >= MIN_HIGH_SURROGATE && ch <= MAX_HIGH_SURROGATE;
}
/**
- * Determines if the given char value is a
- * low-surrogate code unit (also known as trailing-surrogate code
- * unit). Such values do not represent characters by themselves,
- * but are used in the representation of supplementary characters in the UTF-16 encoding.
+ * Determines if the given {@code char} value is a
+ *
+ * Unicode low-surrogate code unit
+ * (also known as trailing-surrogate code unit).
*
- *
This method returns true if and only if
- *
isch >= '\uDC00' && ch <= '\uDFFF' - *
true.
+ * Such values do not represent characters by themselves,
+ * but are used in the representation of
+ * supplementary characters
+ * in the UTF-16 encoding.
*
- * @param ch the char value to be tested.
- * @return true if the char value
- * is between '\uDC00' and '\uDFFF' inclusive;
- * false otherwise.
- * @see java.lang.Character#isHighSurrogate(char)
- * @since 1.5
+ * @param ch the {@code char} value to be tested.
+ * @return {@code true} if the {@code char} value is between
+ * {@link #MIN_LOW_SURROGATE} and
+ * {@link #MAX_LOW_SURROGATE} inclusive;
+ * {@code false} otherwise.
+ * @see #isHighSurrogate(char)
+ * @since 1.5
*/
public static boolean isLowSurrogate(char ch) {
return ch >= MIN_LOW_SURROGATE && ch <= MAX_LOW_SURROGATE;
}
/**
+ * Determines if the given {@code char} value is a Unicode
+ * surrogate code unit.
+ *
+ *
Such values do not represent characters by themselves, + * but are used in the representation of + * supplementary characters + * in the UTF-16 encoding. + * + *
A char value is a surrogate code unit if and only if it is either
+ * a {@linkplain #isLowSurrogate(char) low-surrogate code unit} or
+ * a {@linkplain #isHighSurrogate(char) high-surrogate code unit}.
+ *
+ * @param ch the {@code char} value to be tested.
+ * @return {@code true} if the {@code char} value is between
+ * {@link #MIN_SURROGATE} and
+ * {@link #MAX_SURROGATE} inclusive;
+ * {@code false} otherwise.
+ * @since 1.7
+ */
+ public static boolean isSurrogate(char ch) {
+ return ch >= MIN_SURROGATE && ch <= MAX_SURROGATE;
+ }
+
+ /**
* Determines whether the specified pair of char
- * values is a valid surrogate pair. This method is equivalent to
- * the expression:
+ * values is a valid
+ *
+ * Unicode surrogate pair.
+
+ *
This method is equivalent to the expression: *
* isHighSurrogate(high) && isLowSurrogate(low)
*