For predicates, boundaries are used to describe * the set of characters for which the method will return true. * This syntax uses fairly normal regular expression notation. * See 5.13 of the Unicode Standard, Version 3.0, for the * boundary specification. * *
See http://www.unicode.org
* for more information on the Unicode Standard.
*
* @author Tom Tromey (tromey@cygnus.com)
* @author Paul N. Fisher
* @author Jochen Hoenicke
* @author Eric Blake (ebb9@email.byu.edu)
* @since 1.0
* @status updated to 1.4
*/
public final class Character implements Serializable, Comparable
{
/**
* A subset of Unicode blocks.
*
* @author Paul N. Fisher
* @author Eric Blake (ebb9@email.byu.edu)
* @since 1.2
*/
public static class Subset
{
/** The name of the subset. */
private final String name;
/**
* Construct a new subset of characters.
*
* @param name the name of the subset
* @throws NullPointerException if name is null
*/
protected Subset(String name)
{
// Note that name.toString() is name, unless name was null.
this.name = name.toString();
}
/**
* Compares two Subsets for equality. This is final, and
* restricts the comparison on the == operator, so it returns
* true only for the same object.
*
* @param o the object to compare
* @return true if o is this
*/
public final boolean equals(Object o)
{
return o == this;
}
/**
* Makes the original hashCode of Object final, to be consistent with
* equals.
*
* @return the hash code for this object
*/
public final int hashCode()
{
return super.hashCode();
}
/**
* Returns the name of the subset.
*
* @return the name
*/
public final String toString()
{
return name;
}
} // class Subset
/**
* A family of character subsets in the Unicode specification. A character
* is in at most one of these blocks.
*
* This inner class was generated automatically from
* libjava/gnu/gcj/convert/Blocks-3.txt, by some perl scripts.
* This Unicode definition file can be found on the
* http://www.unicode.org website.
* JDK 1.4 uses Unicode version 3.0.0.
*
* @author scripts/unicode-blocks.pl (written by Eric Blake)
* @since 1.2
*/
public static final class UnicodeBlock extends Subset
{
/** The start of the subset. */
private final char start;
/** The end of the subset. */
private final char end;
/**
* Constructor for strictly defined blocks.
*
* @param start the start character of the range
* @param end the end character of the range
* @param name the block name
*/
private UnicodeBlock(char start, char end, String name)
{
super(name);
this.start = start;
this.end = end;
}
/**
* Returns the Unicode character block which a character belongs to.
*
* @param ch the character to look up
* @return the set it belongs to, or null if it is not in one
*/
public static UnicodeBlock of(char ch)
{
// Special case, since SPECIALS contains two ranges.
if (ch == '\uFEFF')
return SPECIALS;
// Simple binary search for the correct block.
int low = 0;
int hi = sets.length - 1;
while (low <= hi)
{
int mid = (low + hi) >> 1;
UnicodeBlock b = sets[mid];
if (ch < b.start)
hi = mid - 1;
else if (ch > b.end)
low = mid + 1;
else
return b;
}
return null;
}
/**
* Basic Latin.
* '\u0000' - '\u007F'.
*/
public static final UnicodeBlock BASIC_LATIN
= new UnicodeBlock('\u0000', '\u007F',
"BASIC_LATIN");
/**
* Latin-1 Supplement.
* '\u0080' - '\u00FF'.
*/
public static final UnicodeBlock LATIN_1_SUPPLEMENT
= new UnicodeBlock('\u0080', '\u00FF',
"LATIN_1_SUPPLEMENT");
/**
* Latin Extended-A.
* '\u0100' - '\u017F'.
*/
public static final UnicodeBlock LATIN_EXTENDED_A
= new UnicodeBlock('\u0100', '\u017F',
"LATIN_EXTENDED_A");
/**
* Latin Extended-B.
* '\u0180' - '\u024F'.
*/
public static final UnicodeBlock LATIN_EXTENDED_B
= new UnicodeBlock('\u0180', '\u024F',
"LATIN_EXTENDED_B");
/**
* IPA Extensions.
* '\u0250' - '\u02AF'.
*/
public static final UnicodeBlock IPA_EXTENSIONS
= new UnicodeBlock('\u0250', '\u02AF',
"IPA_EXTENSIONS");
/**
* Spacing Modifier Letters.
* '\u02B0' - '\u02FF'.
*/
public static final UnicodeBlock SPACING_MODIFIER_LETTERS
= new UnicodeBlock('\u02B0', '\u02FF',
"SPACING_MODIFIER_LETTERS");
/**
* Combining Diacritical Marks.
* '\u0300' - '\u036F'.
*/
public static final UnicodeBlock COMBINING_DIACRITICAL_MARKS
= new UnicodeBlock('\u0300', '\u036F',
"COMBINING_DIACRITICAL_MARKS");
/**
* Greek.
* '\u0370' - '\u03FF'.
*/
public static final UnicodeBlock GREEK
= new UnicodeBlock('\u0370', '\u03FF',
"GREEK");
/**
* Cyrillic.
* '\u0400' - '\u04FF'.
*/
public static final UnicodeBlock CYRILLIC
= new UnicodeBlock('\u0400', '\u04FF',
"CYRILLIC");
/**
* Armenian.
* '\u0530' - '\u058F'.
*/
public static final UnicodeBlock ARMENIAN
= new UnicodeBlock('\u0530', '\u058F',
"ARMENIAN");
/**
* Hebrew.
* '\u0590' - '\u05FF'.
*/
public static final UnicodeBlock HEBREW
= new UnicodeBlock('\u0590', '\u05FF',
"HEBREW");
/**
* Arabic.
* '\u0600' - '\u06FF'.
*/
public static final UnicodeBlock ARABIC
= new UnicodeBlock('\u0600', '\u06FF',
"ARABIC");
/**
* Syriac.
* '\u0700' - '\u074F'.
* @since 1.4
*/
public static final UnicodeBlock SYRIAC
= new UnicodeBlock('\u0700', '\u074F',
"SYRIAC");
/**
* Thaana.
* '\u0780' - '\u07BF'.
* @since 1.4
*/
public static final UnicodeBlock THAANA
= new UnicodeBlock('\u0780', '\u07BF',
"THAANA");
/**
* Devanagari.
* '\u0900' - '\u097F'.
*/
public static final UnicodeBlock DEVANAGARI
= new UnicodeBlock('\u0900', '\u097F',
"DEVANAGARI");
/**
* Bengali.
* '\u0980' - '\u09FF'.
*/
public static final UnicodeBlock BENGALI
= new UnicodeBlock('\u0980', '\u09FF',
"BENGALI");
/**
* Gurmukhi.
* '\u0A00' - '\u0A7F'.
*/
public static final UnicodeBlock GURMUKHI
= new UnicodeBlock('\u0A00', '\u0A7F',
"GURMUKHI");
/**
* Gujarati.
* '\u0A80' - '\u0AFF'.
*/
public static final UnicodeBlock GUJARATI
= new UnicodeBlock('\u0A80', '\u0AFF',
"GUJARATI");
/**
* Oriya.
* '\u0B00' - '\u0B7F'.
*/
public static final UnicodeBlock ORIYA
= new UnicodeBlock('\u0B00', '\u0B7F',
"ORIYA");
/**
* Tamil.
* '\u0B80' - '\u0BFF'.
*/
public static final UnicodeBlock TAMIL
= new UnicodeBlock('\u0B80', '\u0BFF',
"TAMIL");
/**
* Telugu.
* '\u0C00' - '\u0C7F'.
*/
public static final UnicodeBlock TELUGU
= new UnicodeBlock('\u0C00', '\u0C7F',
"TELUGU");
/**
* Kannada.
* '\u0C80' - '\u0CFF'.
*/
public static final UnicodeBlock KANNADA
= new UnicodeBlock('\u0C80', '\u0CFF',
"KANNADA");
/**
* Malayalam.
* '\u0D00' - '\u0D7F'.
*/
public static final UnicodeBlock MALAYALAM
= new UnicodeBlock('\u0D00', '\u0D7F',
"MALAYALAM");
/**
* Sinhala.
* '\u0D80' - '\u0DFF'.
* @since 1.4
*/
public static final UnicodeBlock SINHALA
= new UnicodeBlock('\u0D80', '\u0DFF',
"SINHALA");
/**
* Thai.
* '\u0E00' - '\u0E7F'.
*/
public static final UnicodeBlock THAI
= new UnicodeBlock('\u0E00', '\u0E7F',
"THAI");
/**
* Lao.
* '\u0E80' - '\u0EFF'.
*/
public static final UnicodeBlock LAO
= new UnicodeBlock('\u0E80', '\u0EFF',
"LAO");
/**
* Tibetan.
* '\u0F00' - '\u0FFF'.
*/
public static final UnicodeBlock TIBETAN
= new UnicodeBlock('\u0F00', '\u0FFF',
"TIBETAN");
/**
* Myanmar.
* '\u1000' - '\u109F'.
* @since 1.4
*/
public static final UnicodeBlock MYANMAR
= new UnicodeBlock('\u1000', '\u109F',
"MYANMAR");
/**
* Georgian.
* '\u10A0' - '\u10FF'.
*/
public static final UnicodeBlock GEORGIAN
= new UnicodeBlock('\u10A0', '\u10FF',
"GEORGIAN");
/**
* Hangul Jamo.
* '\u1100' - '\u11FF'.
*/
public static final UnicodeBlock HANGUL_JAMO
= new UnicodeBlock('\u1100', '\u11FF',
"HANGUL_JAMO");
/**
* Ethiopic.
* '\u1200' - '\u137F'.
* @since 1.4
*/
public static final UnicodeBlock ETHIOPIC
= new UnicodeBlock('\u1200', '\u137F',
"ETHIOPIC");
/**
* Cherokee.
* '\u13A0' - '\u13FF'.
* @since 1.4
*/
public static final UnicodeBlock CHEROKEE
= new UnicodeBlock('\u13A0', '\u13FF',
"CHEROKEE");
/**
* Unified Canadian Aboriginal Syllabics.
* '\u1400' - '\u167F'.
* @since 1.4
*/
public static final UnicodeBlock UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS
= new UnicodeBlock('\u1400', '\u167F',
"UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS");
/**
* Ogham.
* '\u1680' - '\u169F'.
* @since 1.4
*/
public static final UnicodeBlock OGHAM
= new UnicodeBlock('\u1680', '\u169F',
"OGHAM");
/**
* Runic.
* '\u16A0' - '\u16FF'.
* @since 1.4
*/
public static final UnicodeBlock RUNIC
= new UnicodeBlock('\u16A0', '\u16FF',
"RUNIC");
/**
* Khmer.
* '\u1780' - '\u17FF'.
* @since 1.4
*/
public static final UnicodeBlock KHMER
= new UnicodeBlock('\u1780', '\u17FF',
"KHMER");
/**
* Mongolian.
* '\u1800' - '\u18AF'.
* @since 1.4
*/
public static final UnicodeBlock MONGOLIAN
= new UnicodeBlock('\u1800', '\u18AF',
"MONGOLIAN");
/**
* Latin Extended Additional.
* '\u1E00' - '\u1EFF'.
*/
public static final UnicodeBlock LATIN_EXTENDED_ADDITIONAL
= new UnicodeBlock('\u1E00', '\u1EFF',
"LATIN_EXTENDED_ADDITIONAL");
/**
* Greek Extended.
* '\u1F00' - '\u1FFF'.
*/
public static final UnicodeBlock GREEK_EXTENDED
= new UnicodeBlock('\u1F00', '\u1FFF',
"GREEK_EXTENDED");
/**
* General Punctuation.
* '\u2000' - '\u206F'.
*/
public static final UnicodeBlock GENERAL_PUNCTUATION
= new UnicodeBlock('\u2000', '\u206F',
"GENERAL_PUNCTUATION");
/**
* Superscripts and Subscripts.
* '\u2070' - '\u209F'.
*/
public static final UnicodeBlock SUPERSCRIPTS_AND_SUBSCRIPTS
= new UnicodeBlock('\u2070', '\u209F',
"SUPERSCRIPTS_AND_SUBSCRIPTS");
/**
* Currency Symbols.
* '\u20A0' - '\u20CF'.
*/
public static final UnicodeBlock CURRENCY_SYMBOLS
= new UnicodeBlock('\u20A0', '\u20CF',
"CURRENCY_SYMBOLS");
/**
* Combining Marks for Symbols.
* '\u20D0' - '\u20FF'.
*/
public static final UnicodeBlock COMBINING_MARKS_FOR_SYMBOLS
= new UnicodeBlock('\u20D0', '\u20FF',
"COMBINING_MARKS_FOR_SYMBOLS");
/**
* Letterlike Symbols.
* '\u2100' - '\u214F'.
*/
public static final UnicodeBlock LETTERLIKE_SYMBOLS
= new UnicodeBlock('\u2100', '\u214F',
"LETTERLIKE_SYMBOLS");
/**
* Number Forms.
* '\u2150' - '\u218F'.
*/
public static final UnicodeBlock NUMBER_FORMS
= new UnicodeBlock('\u2150', '\u218F',
"NUMBER_FORMS");
/**
* Arrows.
* '\u2190' - '\u21FF'.
*/
public static final UnicodeBlock ARROWS
= new UnicodeBlock('\u2190', '\u21FF',
"ARROWS");
/**
* Mathematical Operators.
* '\u2200' - '\u22FF'.
*/
public static final UnicodeBlock MATHEMATICAL_OPERATORS
= new UnicodeBlock('\u2200', '\u22FF',
"MATHEMATICAL_OPERATORS");
/**
* Miscellaneous Technical.
* '\u2300' - '\u23FF'.
*/
public static final UnicodeBlock MISCELLANEOUS_TECHNICAL
= new UnicodeBlock('\u2300', '\u23FF',
"MISCELLANEOUS_TECHNICAL");
/**
* Control Pictures.
* '\u2400' - '\u243F'.
*/
public static final UnicodeBlock CONTROL_PICTURES
= new UnicodeBlock('\u2400', '\u243F',
"CONTROL_PICTURES");
/**
* Optical Character Recognition.
* '\u2440' - '\u245F'.
*/
public static final UnicodeBlock OPTICAL_CHARACTER_RECOGNITION
= new UnicodeBlock('\u2440', '\u245F',
"OPTICAL_CHARACTER_RECOGNITION");
/**
* Enclosed Alphanumerics.
* '\u2460' - '\u24FF'.
*/
public static final UnicodeBlock ENCLOSED_ALPHANUMERICS
= new UnicodeBlock('\u2460', '\u24FF',
"ENCLOSED_ALPHANUMERICS");
/**
* Box Drawing.
* '\u2500' - '\u257F'.
*/
public static final UnicodeBlock BOX_DRAWING
= new UnicodeBlock('\u2500', '\u257F',
"BOX_DRAWING");
/**
* Block Elements.
* '\u2580' - '\u259F'.
*/
public static final UnicodeBlock BLOCK_ELEMENTS
= new UnicodeBlock('\u2580', '\u259F',
"BLOCK_ELEMENTS");
/**
* Geometric Shapes.
* '\u25A0' - '\u25FF'.
*/
public static final UnicodeBlock GEOMETRIC_SHAPES
= new UnicodeBlock('\u25A0', '\u25FF',
"GEOMETRIC_SHAPES");
/**
* Miscellaneous Symbols.
* '\u2600' - '\u26FF'.
*/
public static final UnicodeBlock MISCELLANEOUS_SYMBOLS
= new UnicodeBlock('\u2600', '\u26FF',
"MISCELLANEOUS_SYMBOLS");
/**
* Dingbats.
* '\u2700' - '\u27BF'.
*/
public static final UnicodeBlock DINGBATS
= new UnicodeBlock('\u2700', '\u27BF',
"DINGBATS");
/**
* Braille Patterns.
* '\u2800' - '\u28FF'.
* @since 1.4
*/
public static final UnicodeBlock BRAILLE_PATTERNS
= new UnicodeBlock('\u2800', '\u28FF',
"BRAILLE_PATTERNS");
/**
* CJK Radicals Supplement.
* '\u2E80' - '\u2EFF'.
* @since 1.4
*/
public static final UnicodeBlock CJK_RADICALS_SUPPLEMENT
= new UnicodeBlock('\u2E80', '\u2EFF',
"CJK_RADICALS_SUPPLEMENT");
/**
* Kangxi Radicals.
* '\u2F00' - '\u2FDF'.
* @since 1.4
*/
public static final UnicodeBlock KANGXI_RADICALS
= new UnicodeBlock('\u2F00', '\u2FDF',
"KANGXI_RADICALS");
/**
* Ideographic Description Characters.
* '\u2FF0' - '\u2FFF'.
* @since 1.4
*/
public static final UnicodeBlock IDEOGRAPHIC_DESCRIPTION_CHARACTERS
= new UnicodeBlock('\u2FF0', '\u2FFF',
"IDEOGRAPHIC_DESCRIPTION_CHARACTERS");
/**
* CJK Symbols and Punctuation.
* '\u3000' - '\u303F'.
*/
public static final UnicodeBlock CJK_SYMBOLS_AND_PUNCTUATION
= new UnicodeBlock('\u3000', '\u303F',
"CJK_SYMBOLS_AND_PUNCTUATION");
/**
* Hiragana.
* '\u3040' - '\u309F'.
*/
public static final UnicodeBlock HIRAGANA
= new UnicodeBlock('\u3040', '\u309F',
"HIRAGANA");
/**
* Katakana.
* '\u30A0' - '\u30FF'.
*/
public static final UnicodeBlock KATAKANA
= new UnicodeBlock('\u30A0', '\u30FF',
"KATAKANA");
/**
* Bopomofo.
* '\u3100' - '\u312F'.
*/
public static final UnicodeBlock BOPOMOFO
= new UnicodeBlock('\u3100', '\u312F',
"BOPOMOFO");
/**
* Hangul Compatibility Jamo.
* '\u3130' - '\u318F'.
*/
public static final UnicodeBlock HANGUL_COMPATIBILITY_JAMO
= new UnicodeBlock('\u3130', '\u318F',
"HANGUL_COMPATIBILITY_JAMO");
/**
* Kanbun.
* '\u3190' - '\u319F'.
*/
public static final UnicodeBlock KANBUN
= new UnicodeBlock('\u3190', '\u319F',
"KANBUN");
/**
* Bopomofo Extended.
* '\u31A0' - '\u31BF'.
* @since 1.4
*/
public static final UnicodeBlock BOPOMOFO_EXTENDED
= new UnicodeBlock('\u31A0', '\u31BF',
"BOPOMOFO_EXTENDED");
/**
* Enclosed CJK Letters and Months.
* '\u3200' - '\u32FF'.
*/
public static final UnicodeBlock ENCLOSED_CJK_LETTERS_AND_MONTHS
= new UnicodeBlock('\u3200', '\u32FF',
"ENCLOSED_CJK_LETTERS_AND_MONTHS");
/**
* CJK Compatibility.
* '\u3300' - '\u33FF'.
*/
public static final UnicodeBlock CJK_COMPATIBILITY
= new UnicodeBlock('\u3300', '\u33FF',
"CJK_COMPATIBILITY");
/**
* CJK Unified Ideographs Extension A.
* '\u3400' - '\u4DB5'.
* @since 1.4
*/
public static final UnicodeBlock CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A
= new UnicodeBlock('\u3400', '\u4DB5',
"CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A");
/**
* CJK Unified Ideographs.
* '\u4E00' - '\u9FFF'.
*/
public static final UnicodeBlock CJK_UNIFIED_IDEOGRAPHS
= new UnicodeBlock('\u4E00', '\u9FFF',
"CJK_UNIFIED_IDEOGRAPHS");
/**
* Yi Syllables.
* '\uA000' - '\uA48F'.
* @since 1.4
*/
public static final UnicodeBlock YI_SYLLABLES
= new UnicodeBlock('\uA000', '\uA48F',
"YI_SYLLABLES");
/**
* Yi Radicals.
* '\uA490' - '\uA4CF'.
* @since 1.4
*/
public static final UnicodeBlock YI_RADICALS
= new UnicodeBlock('\uA490', '\uA4CF',
"YI_RADICALS");
/**
* Hangul Syllables.
* '\uAC00' - '\uD7A3'.
*/
public static final UnicodeBlock HANGUL_SYLLABLES
= new UnicodeBlock('\uAC00', '\uD7A3',
"HANGUL_SYLLABLES");
/**
* Surrogates Area.
* '\uD800' - '\uDFFF'.
*/
public static final UnicodeBlock SURROGATES_AREA
= new UnicodeBlock('\uD800', '\uDFFF',
"SURROGATES_AREA");
/**
* Private Use Area.
* '\uE000' - '\uF8FF'.
*/
public static final UnicodeBlock PRIVATE_USE_AREA
= new UnicodeBlock('\uE000', '\uF8FF',
"PRIVATE_USE_AREA");
/**
* CJK Compatibility Ideographs.
* '\uF900' - '\uFAFF'.
*/
public static final UnicodeBlock CJK_COMPATIBILITY_IDEOGRAPHS
= new UnicodeBlock('\uF900', '\uFAFF',
"CJK_COMPATIBILITY_IDEOGRAPHS");
/**
* Alphabetic Presentation Forms.
* '\uFB00' - '\uFB4F'.
*/
public static final UnicodeBlock ALPHABETIC_PRESENTATION_FORMS
= new UnicodeBlock('\uFB00', '\uFB4F',
"ALPHABETIC_PRESENTATION_FORMS");
/**
* Arabic Presentation Forms-A.
* '\uFB50' - '\uFDFF'.
*/
public static final UnicodeBlock ARABIC_PRESENTATION_FORMS_A
= new UnicodeBlock('\uFB50', '\uFDFF',
"ARABIC_PRESENTATION_FORMS_A");
/**
* Combining Half Marks.
* '\uFE20' - '\uFE2F'.
*/
public static final UnicodeBlock COMBINING_HALF_MARKS
= new UnicodeBlock('\uFE20', '\uFE2F',
"COMBINING_HALF_MARKS");
/**
* CJK Compatibility Forms.
* '\uFE30' - '\uFE4F'.
*/
public static final UnicodeBlock CJK_COMPATIBILITY_FORMS
= new UnicodeBlock('\uFE30', '\uFE4F',
"CJK_COMPATIBILITY_FORMS");
/**
* Small Form Variants.
* '\uFE50' - '\uFE6F'.
*/
public static final UnicodeBlock SMALL_FORM_VARIANTS
= new UnicodeBlock('\uFE50', '\uFE6F',
"SMALL_FORM_VARIANTS");
/**
* Arabic Presentation Forms-B.
* '\uFE70' - '\uFEFE'.
*/
public static final UnicodeBlock ARABIC_PRESENTATION_FORMS_B
= new UnicodeBlock('\uFE70', '\uFEFE',
"ARABIC_PRESENTATION_FORMS_B");
/**
* Halfwidth and Fullwidth Forms.
* '\uFF00' - '\uFFEF'.
*/
public static final UnicodeBlock HALFWIDTH_AND_FULLWIDTH_FORMS
= new UnicodeBlock('\uFF00', '\uFFEF',
"HALFWIDTH_AND_FULLWIDTH_FORMS");
/**
* Specials.
* '\uFEFF', '\uFFF0' - '\uFFFD'.
*/
public static final UnicodeBlock SPECIALS
= new UnicodeBlock('\uFFF0', '\uFFFD',
"SPECIALS");
/**
* The defined subsets.
*/
private static final UnicodeBlock sets[] = {
BASIC_LATIN,
LATIN_1_SUPPLEMENT,
LATIN_EXTENDED_A,
LATIN_EXTENDED_B,
IPA_EXTENSIONS,
SPACING_MODIFIER_LETTERS,
COMBINING_DIACRITICAL_MARKS,
GREEK,
CYRILLIC,
ARMENIAN,
HEBREW,
ARABIC,
SYRIAC,
THAANA,
DEVANAGARI,
BENGALI,
GURMUKHI,
GUJARATI,
ORIYA,
TAMIL,
TELUGU,
KANNADA,
MALAYALAM,
SINHALA,
THAI,
LAO,
TIBETAN,
MYANMAR,
GEORGIAN,
HANGUL_JAMO,
ETHIOPIC,
CHEROKEE,
UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS,
OGHAM,
RUNIC,
KHMER,
MONGOLIAN,
LATIN_EXTENDED_ADDITIONAL,
GREEK_EXTENDED,
GENERAL_PUNCTUATION,
SUPERSCRIPTS_AND_SUBSCRIPTS,
CURRENCY_SYMBOLS,
COMBINING_MARKS_FOR_SYMBOLS,
LETTERLIKE_SYMBOLS,
NUMBER_FORMS,
ARROWS,
MATHEMATICAL_OPERATORS,
MISCELLANEOUS_TECHNICAL,
CONTROL_PICTURES,
OPTICAL_CHARACTER_RECOGNITION,
ENCLOSED_ALPHANUMERICS,
BOX_DRAWING,
BLOCK_ELEMENTS,
GEOMETRIC_SHAPES,
MISCELLANEOUS_SYMBOLS,
DINGBATS,
BRAILLE_PATTERNS,
CJK_RADICALS_SUPPLEMENT,
KANGXI_RADICALS,
IDEOGRAPHIC_DESCRIPTION_CHARACTERS,
CJK_SYMBOLS_AND_PUNCTUATION,
HIRAGANA,
KATAKANA,
BOPOMOFO,
HANGUL_COMPATIBILITY_JAMO,
KANBUN,
BOPOMOFO_EXTENDED,
ENCLOSED_CJK_LETTERS_AND_MONTHS,
CJK_COMPATIBILITY,
CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A,
CJK_UNIFIED_IDEOGRAPHS,
YI_SYLLABLES,
YI_RADICALS,
HANGUL_SYLLABLES,
SURROGATES_AREA,
PRIVATE_USE_AREA,
CJK_COMPATIBILITY_IDEOGRAPHS,
ALPHABETIC_PRESENTATION_FORMS,
ARABIC_PRESENTATION_FORMS_A,
COMBINING_HALF_MARKS,
CJK_COMPATIBILITY_FORMS,
SMALL_FORM_VARIANTS,
ARABIC_PRESENTATION_FORMS_B,
HALFWIDTH_AND_FULLWIDTH_FORMS,
SPECIALS,
};
} // class UnicodeBlock
/**
* The immutable value of this Character.
*
* @serial the value of this Character
*/
private final char value;
/**
* Compatible with JDK 1.0+.
*/
private static final long serialVersionUID = 3786198910865385080L;
/**
* Smallest value allowed for radix arguments in Java. This value is 2.
*
* @see #digit(char, int)
* @see #forDigit(int, int)
* @see Integer#toString(int, int)
* @see Integer#valueOf(String)
*/
public static final int MIN_RADIX = 2;
/**
* Largest value allowed for radix arguments in Java. This value is 36.
*
* @see #digit(char, int)
* @see #forDigit(int, int)
* @see Integer#toString(int, int)
* @see Integer#valueOf(String)
*/
public static final int MAX_RADIX = 36;
/**
* The minimum value the char data type can hold.
* This value is '\\u0000'.
*/
public static final char MIN_VALUE = '\u0000';
/**
* The maximum value the char data type can hold.
* This value is '\\uFFFF'.
*/
public static final char MAX_VALUE = '\uFFFF';
/**
* Class object representing the primitive char data type.
*
* @since 1.1
*/
public static final Class TYPE = VMClassLoader.getPrimitiveClass('C');
/**
* Lu = Letter, Uppercase (Informative).
*
* @since 1.1
*/
public static final byte UPPERCASE_LETTER = 1;
/**
* Ll = Letter, Lowercase (Informative).
*
* @since 1.1
*/
public static final byte LOWERCASE_LETTER = 2;
/**
* Lt = Letter, Titlecase (Informative).
*
* @since 1.1
*/
public static final byte TITLECASE_LETTER = 3;
/**
* Mn = Mark, Non-Spacing (Normative).
*
* @since 1.1
*/
public static final byte NON_SPACING_MARK = 6;
/**
* Mc = Mark, Spacing Combining (Normative).
*
* @since 1.1
*/
public static final byte COMBINING_SPACING_MARK = 8;
/**
* Me = Mark, Enclosing (Normative).
*
* @since 1.1
*/
public static final byte ENCLOSING_MARK = 7;
/**
* Nd = Number, Decimal Digit (Normative).
*
* @since 1.1
*/
public static final byte DECIMAL_DIGIT_NUMBER = 9;
/**
* Nl = Number, Letter (Normative).
*
* @since 1.1
*/
public static final byte LETTER_NUMBER = 10;
/**
* No = Number, Other (Normative).
*
* @since 1.1
*/
public static final byte OTHER_NUMBER = 11;
/**
* Zs = Separator, Space (Normative).
*
* @since 1.1
*/
public static final byte SPACE_SEPARATOR = 12;
/**
* Zl = Separator, Line (Normative).
*
* @since 1.1
*/
public static final byte LINE_SEPARATOR = 13;
/**
* Zp = Separator, Paragraph (Normative).
*
* @since 1.1
*/
public static final byte PARAGRAPH_SEPARATOR = 14;
/**
* Cc = Other, Control (Normative).
*
* @since 1.1
*/
public static final byte CONTROL = 15;
/**
* Cf = Other, Format (Normative).
*
* @since 1.1
*/
public static final byte FORMAT = 16;
/**
* Cs = Other, Surrogate (Normative).
*
* @since 1.1
*/
public static final byte SURROGATE = 19;
/**
* Co = Other, Private Use (Normative).
*
* @since 1.1
*/
public static final byte PRIVATE_USE = 18;
/**
* Cn = Other, Not Assigned (Normative).
*
* @since 1.1
*/
public static final byte UNASSIGNED = 0;
/**
* Lm = Letter, Modifier (Informative).
*
* @since 1.1
*/
public static final byte MODIFIER_LETTER = 4;
/**
* Lo = Letter, Other (Informative).
*
* @since 1.1
*/
public static final byte OTHER_LETTER = 5;
/**
* Pc = Punctuation, Connector (Informative).
*
* @since 1.1
*/
public static final byte CONNECTOR_PUNCTUATION = 23;
/**
* Pd = Punctuation, Dash (Informative).
*
* @since 1.1
*/
public static final byte DASH_PUNCTUATION = 20;
/**
* Ps = Punctuation, Open (Informative).
*
* @since 1.1
*/
public static final byte START_PUNCTUATION = 21;
/**
* Pe = Punctuation, Close (Informative).
*
* @since 1.1
*/
public static final byte END_PUNCTUATION = 22;
/**
* Pi = Punctuation, Initial Quote (Informative).
*
* @since 1.4
*/
public static final byte INITIAL_QUOTE_PUNCTUATION = 29;
/**
* Pf = Punctuation, Final Quote (Informative).
*
* @since 1.4
*/
public static final byte FINAL_QUOTE_PUNCTUATION = 30;
/**
* Po = Punctuation, Other (Informative).
*
* @since 1.1
*/
public static final byte OTHER_PUNCTUATION = 24;
/**
* Sm = Symbol, Math (Informative).
*
* @since 1.1
*/
public static final byte MATH_SYMBOL = 25;
/**
* Sc = Symbol, Currency (Informative).
*
* @since 1.1
*/
public static final byte CURRENCY_SYMBOL = 26;
/**
* Sk = Symbol, Modifier (Informative).
*
* @since 1.1
*/
public static final byte MODIFIER_SYMBOL = 27;
/**
* So = Symbol, Other (Informative).
*
* @since 1.1
*/
public static final byte OTHER_SYMBOL = 28;
/**
* Undefined bidirectional character type. Undefined char values have
* undefined directionality in the Unicode specification.
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_UNDEFINED = -1;
/**
* Strong bidirectional character type "L".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_LEFT_TO_RIGHT = 0;
/**
* Strong bidirectional character type "R".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_RIGHT_TO_LEFT = 1;
/**
* Strong bidirectional character type "AL".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_RIGHT_TO_LEFT_ARABIC = 2;
/**
* Weak bidirectional character type "EN".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_EUROPEAN_NUMBER = 3;
/**
* Weak bidirectional character type "ES".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_EUROPEAN_NUMBER_SEPARATOR = 4;
/**
* Weak bidirectional character type "ET".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_EUROPEAN_NUMBER_TERMINATOR = 5;
/**
* Weak bidirectional character type "AN".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_ARABIC_NUMBER = 6;
/**
* Weak bidirectional character type "CS".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_COMMON_NUMBER_SEPARATOR = 7;
/**
* Weak bidirectional character type "NSM".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_NONSPACING_MARK = 8;
/**
* Weak bidirectional character type "BN".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_BOUNDARY_NEUTRAL = 9;
/**
* Neutral bidirectional character type "B".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_PARAGRAPH_SEPARATOR = 10;
/**
* Neutral bidirectional character type "S".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_SEGMENT_SEPARATOR = 11;
/**
* Strong bidirectional character type "WS".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_WHITESPACE = 12;
/**
* Neutral bidirectional character type "ON".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_OTHER_NEUTRALS = 13;
/**
* Strong bidirectional character type "LRE".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_LEFT_TO_RIGHT_EMBEDDING = 14;
/**
* Strong bidirectional character type "LRO".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_LEFT_TO_RIGHT_OVERRIDE = 15;
/**
* Strong bidirectional character type "RLE".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_RIGHT_TO_LEFT_EMBEDDING = 16;
/**
* Strong bidirectional character type "RLO".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_RIGHT_TO_LEFT_OVERRIDE = 17;
/**
* Weak bidirectional character type "PDF".
*
* @since 1.4
*/
public static final byte DIRECTIONALITY_POP_DIRECTIONAL_FORMAT = 18;
/**
* Mask for grabbing the type out of the result of readChar.
* @see #readChar(char)
*/
private static final int TYPE_MASK = 0x1F;
/**
* Mask for grabbing the non-breaking space flag out of the result of
* readChar.
* @see #readChar(char)
*/
private static final int NO_BREAK_MASK = 0x20;
/**
* Mask for grabbing the mirrored directionality flag out of the result
* of readChar.
* @see #readChar(char)
*/
private static final int MIRROR_MASK = 0x40;
/**
* Grabs an attribute offset from the Unicode attribute database. The lower
* 5 bits are the character type, the next 2 bits are flags, and the top
* 9 bits are the offset into the attribute tables. Note that the top 9
* bits are meaningless in this context; they are useful only in the native
* code.
*
* @param ch the character to look up
* @return the character's attribute offset and type
* @see #TYPE_MASK
* @see #NO_BREAK_MASK
* @see #MIRROR_MASK
*/
private static native char readChar(char ch);
/**
* Wraps up a character.
*
* @param value the character to wrap
*/
public Character(char value)
{
this.value = value;
}
/**
* Returns the character which has been wrapped by this class.
*
* @return the character wrapped
*/
public char charValue()
{
return value;
}
/**
* Returns the numerical value (unsigned) of the wrapped character.
* Range of returned values: 0x0000-0xFFFF.
*
* @return the value of the wrapped character
*/
public int hashCode()
{
return value;
}
/**
* Determines if an object is equal to this object. This is only true for
* another Character object wrapping the same value.
*
* @param o object to compare
* @return true if o is a Character with the same value
*/
public boolean equals(Object o)
{
return o instanceof Character && value == ((Character) o).value;
}
/**
* Converts the wrapped character into a String.
*
* @return a String containing one character -- the wrapped character
* of this instance
*/
public String toString()
{
// This assumes that String.valueOf(char) can create a single-character
// String more efficiently than through the public API.
return String.valueOf(value);
}
/**
* Returns a String of length 1 representing the specified character.
*
* @param ch the character to convert
* @return a String containing the character
* @since 1.4
*/
public static String toString(char ch)
{
// This assumes that String.valueOf(char) can create a single-character
// String more efficiently than through the public API.
return String.valueOf(ch);
}
/**
* Determines if a character is a Unicode lowercase letter. For example,
* 'a' is lowercase.
*
* lowercase = [Ll]
*
* @param ch character to test
* @return true if ch is a Unicode lowercase letter, else false
* @see #isUpperCase(char)
* @see #isTitleCase(char)
* @see #toLowerCase(char)
* @see #getType(char)
*/
public static boolean isLowerCase(char ch)
{
return getType(ch) == LOWERCASE_LETTER;
}
/**
* Determines if a character is a Unicode uppercase letter. For example,
* 'A' is uppercase.
*
* uppercase = [Lu]
*
* @param ch character to test
* @return true if ch is a Unicode uppercase letter, else false
* @see #isLowerCase(char)
* @see #isTitleCase(char)
* @see #toUpperCase(char)
* @see #getType(char)
*/
public static boolean isUpperCase(char ch)
{
return getType(ch) == UPPERCASE_LETTER;
}
/**
* Determines if a character is a Unicode titlecase letter. For example,
* the character "Lj" (Latin capital L with small letter j) is titlecase.
*
* titlecase = [Lt]
*
* @param ch character to test
* @return true if ch is a Unicode titlecase letter, else false
* @see #isLowerCase(char)
* @see #isUpperCase(char)
* @see #toTitleCase(char)
* @see #getType(char)
*/
public static boolean isTitleCase(char ch)
{
return getType(ch) == TITLECASE_LETTER;
}
/**
* Determines if a character is a Unicode decimal digit. For example,
* '0' is a digit.
*
* Unicode decimal digit = [Nd]
*
* @param ch character to test
* @return true if ch is a Unicode decimal digit, else false
* @see #digit(char, int)
* @see #forDigit(int, int)
* @see #getType(char)
*/
public static boolean isDigit(char ch)
{
return getType(ch) == DECIMAL_DIGIT_NUMBER;
}
/**
* Determines if a character is part of the Unicode Standard. This is an
* evolving standard, but covers every character in the data file.
*
* defined = not [Cn]
*
* @param ch character to test
* @return true if ch is a Unicode character, else false
* @see #isDigit(char)
* @see #isLetter(char)
* @see #isLetterOrDigit(char)
* @see #isLowerCase(char)
* @see #isTitleCase(char)
* @see #isUpperCase(char)
*/
public static boolean isDefined(char ch)
{
return getType(ch) != UNASSIGNED;
}
/**
* Determines if a character is a Unicode letter. Not all letters have case,
* so this may return true when isLowerCase and isUpperCase return false.
*
* letter = [Lu]|[Ll]|[Lt]|[Lm]|[Lo]
*
* @param ch character to test
* @return true if ch is a Unicode letter, else false
* @see #isDigit(char)
* @see #isJavaIdentifierStart(char)
* @see #isJavaLetter(char)
* @see #isJavaLetterOrDigit(char)
* @see #isLetterOrDigit(char)
* @see #isLowerCase(char)
* @see #isTitleCase(char)
* @see #isUnicodeIdentifierStart(char)
* @see #isUpperCase(char)
*/
public static boolean isLetter(char ch)
{
return ((1 << getType(ch))
& ((1 << UPPERCASE_LETTER)
| (1 << LOWERCASE_LETTER)
| (1 << TITLECASE_LETTER)
| (1 << MODIFIER_LETTER)
| (1 << OTHER_LETTER))) != 0;
}
/**
* Determines if a character is a Unicode letter or a Unicode digit. This
* is the combination of isLetter and isDigit.
*
* letter or digit = [Lu]|[Ll]|[Lt]|[Lm]|[Lo]|[Nd]
*
* @param ch character to test
* @return true if ch is a Unicode letter or a Unicode digit, else false
* @see #isDigit(char)
* @see #isJavaIdentifierPart(char)
* @see #isJavaLetter(char)
* @see #isJavaLetterOrDigit(char)
* @see #isLetter(char)
* @see #isUnicodeIdentifierPart(char)
*/
public static boolean isLetterOrDigit(char ch)
{
return ((1 << getType(ch))
& ((1 << UPPERCASE_LETTER)
| (1 << LOWERCASE_LETTER)
| (1 << TITLECASE_LETTER)
| (1 << MODIFIER_LETTER)
| (1 << OTHER_LETTER)
| (1 << DECIMAL_DIGIT_NUMBER))) != 0;
}
/**
* Determines if a character can start a Java identifier. This is the
* combination of isLetter, any character where getType returns
* LETTER_NUMBER, currency symbols (like '$'), and connecting punctuation
* (like '_').
*
* @param ch character to test
* @return true if ch can start a Java identifier, else false
* @deprecated Replaced by {@link #isJavaIdentifierStart(char)}
* @see #isJavaLetterOrDigit(char)
* @see #isJavaIdentifierStart(char)
* @see #isJavaIdentifierPart(char)
* @see #isLetter(char)
* @see #isLetterOrDigit(char)
* @see #isUnicodeIdentifierStart(char)
*/
public static boolean isJavaLetter(char ch)
{
return isJavaIdentifierStart(ch);
}
/**
* Determines if a character can follow the first letter in
* a Java identifier. This is the combination of isJavaLetter (isLetter,
* type of LETTER_NUMBER, currency, connecting punctuation) and digit,
* numeric letter (like Roman numerals), combining marks, non-spacing marks,
* or isIdentifierIgnorable.
*
* @param ch character to test
* @return true if ch can follow the first letter in a Java identifier
* @deprecated Replaced by {@link #isJavaIdentifierPart(char)}
* @see #isJavaLetter(char)
* @see #isJavaIdentifierStart(char)
* @see #isJavaIdentifierPart(char)
* @see #isLetter(char)
* @see #isLetterOrDigit(char)
* @see #isUnicodeIdentifierPart(char)
* @see #isIdentifierIgnorable(char)
*/
public static boolean isJavaLetterOrDigit(char ch)
{
return isJavaIdentifierPart(ch);
}
/**
* Determines if a character can start a Java identifier. This is the
* combination of isLetter, any character where getType returns
* LETTER_NUMBER, currency symbols (like '$'), and connecting punctuation
* (like '_').
*
* Java identifier start = [Lu]|[Ll]|[Lt]|[Lm]|[Lo]|[Nl]|[Sc]|[Pc]
*
* @param ch character to test
* @return true if ch can start a Java identifier, else false
* @see #isJavaIdentifierPart(char)
* @see #isLetter(char)
* @see #isUnicodeIdentifierStart(char)
* @since 1.1
*/
public static boolean isJavaIdentifierStart(char ch)
{
return ((1 << getType(ch))
& ((1 << UPPERCASE_LETTER)
| (1 << LOWERCASE_LETTER)
| (1 << TITLECASE_LETTER)
| (1 << MODIFIER_LETTER)
| (1 << OTHER_LETTER)
| (1 << LETTER_NUMBER)
| (1 << CURRENCY_SYMBOL)
| (1 << CONNECTOR_PUNCTUATION))) != 0;
}
/**
* Determines if a character can follow the first letter in
* a Java identifier. This is the combination of isJavaLetter (isLetter,
* type of LETTER_NUMBER, currency, connecting punctuation) and digit,
* numeric letter (like Roman numerals), combining marks, non-spacing marks,
* or isIdentifierIgnorable.
*
* Java identifier extender =
* [Lu]|[Ll]|[Lt]|[Lm]|[Lo]|[Nl]|[Sc]|[Pc]|[Mn]|[Mc]|[Nd]|[Cf]
* |U+0000-U+0008|U+000E-U+001B|U+007F-U+009F
*
* @param ch character to test
* @return true if ch can follow the first letter in a Java identifier
* @see #isIdentifierIgnorable(char)
* @see #isJavaIdentifierStart(char)
* @see #isLetterOrDigit(char)
* @see #isUnicodeIdentifierPart(char)
* @since 1.1
*/
public static boolean isJavaIdentifierPart(char ch)
{
int category = getType(ch);
return ((1 << category)
& ((1 << UPPERCASE_LETTER)
| (1 << LOWERCASE_LETTER)
| (1 << TITLECASE_LETTER)
| (1 << MODIFIER_LETTER)
| (1 << OTHER_LETTER)
| (1 << NON_SPACING_MARK)
| (1 << COMBINING_SPACING_MARK)
| (1 << DECIMAL_DIGIT_NUMBER)
| (1 << LETTER_NUMBER)
| (1 << CURRENCY_SYMBOL)
| (1 << CONNECTOR_PUNCTUATION)
| (1 << FORMAT))) != 0
|| (category == CONTROL && isIdentifierIgnorable(ch));
}
/**
* Determines if a character can start a Unicode identifier. Only
* letters can start a Unicode identifier, but this includes characters
* in LETTER_NUMBER.
*
* Unicode identifier start = [Lu]|[Ll]|[Lt]|[Lm]|[Lo]|[Nl]
*
* @param ch character to test
* @return true if ch can start a Unicode identifier, else false
* @see #isJavaIdentifierStart(char)
* @see #isLetter(char)
* @see #isUnicodeIdentifierPart(char)
* @since 1.1
*/
public static boolean isUnicodeIdentifierStart(char ch)
{
return ((1 << getType(ch))
& ((1 << UPPERCASE_LETTER)
| (1 << LOWERCASE_LETTER)
| (1 << TITLECASE_LETTER)
| (1 << MODIFIER_LETTER)
| (1 << OTHER_LETTER)
| (1 << LETTER_NUMBER))) != 0;
}
/**
* Determines if a character can follow the first letter in
* a Unicode identifier. This includes letters, connecting punctuation,
* digits, numeric letters, combining marks, non-spacing marks, and
* isIdentifierIgnorable.
*
* Unicode identifier extender =
* [Lu]|[Ll]|[Lt]|[Lm]|[Lo]|[Nl]|[Mn]|[Mc]|[Nd]|[Pc]|[Cf]|
* |U+0000-U+0008|U+000E-U+001B|U+007F-U+009F
*
* @param ch character to test
* @return true if ch can follow the first letter in a Unicode identifier
* @see #isIdentifierIgnorable(char)
* @see #isJavaIdentifierPart(char)
* @see #isLetterOrDigit(char)
* @see #isUnicodeIdentifierStart(char)
* @since 1.1
*/
public static boolean isUnicodeIdentifierPart(char ch)
{
int category = getType(ch);
return ((1 << category)
& ((1 << UPPERCASE_LETTER)
| (1 << LOWERCASE_LETTER)
| (1 << TITLECASE_LETTER)
| (1 << MODIFIER_LETTER)
| (1 << OTHER_LETTER)
| (1 << NON_SPACING_MARK)
| (1 << COMBINING_SPACING_MARK)
| (1 << DECIMAL_DIGIT_NUMBER)
| (1 << LETTER_NUMBER)
| (1 << CONNECTOR_PUNCTUATION)
| (1 << FORMAT))) != 0
|| (category == CONTROL && isIdentifierIgnorable(ch));
}
/**
* Determines if a character is ignorable in a Unicode identifier. This
* includes the non-whitespace ISO control characters ('\u0000'
* through '\u0008', '\u000E' through
* '\u001B', and '\u007F' through
* '\u009F'), and FORMAT characters.
*
* Unicode identifier ignorable = [Cf]|U+0000-U+0008|U+000E-U+001B
* |U+007F-U+009F
*
* @param ch character to test
* @return true if ch is ignorable in a Unicode or Java identifier
* @see #isJavaIdentifierPart(char)
* @see #isUnicodeIdentifierPart(char)
* @since 1.1
*/
public static boolean isIdentifierIgnorable(char ch)
{
return (ch <= '\u009F' && (ch < '\t' || ch >= '\u007F'
|| (ch <= '\u001B' && ch >= '\u000E')))
|| getType(ch) == FORMAT;
}
/**
* Converts a Unicode character into its lowercase equivalent mapping.
* If a mapping does not exist, then the character passed is returned.
* Note that isLowerCase(toLowerCase(ch)) does not always return true.
*
* @param ch character to convert to lowercase
* @return lowercase mapping of ch, or ch if lowercase mapping does
* not exist
* @see #isLowerCase(char)
* @see #isUpperCase(char)
* @see #toTitleCase(char)
* @see #toUpperCase(char)
*/
public static native char toLowerCase(char ch);
/**
* Converts a Unicode character into its uppercase equivalent mapping.
* If a mapping does not exist, then the character passed is returned.
* Note that isUpperCase(toUpperCase(ch)) does not always return true.
*
* @param ch character to convert to uppercase
* @return uppercase mapping of ch, or ch if uppercase mapping does
* not exist
* @see #isLowerCase(char)
* @see #isUpperCase(char)
* @see #toLowerCase(char)
* @see #toTitleCase(char)
*/
public static native char toUpperCase(char ch);
/**
* Converts a Unicode character into its titlecase equivalent mapping.
* If a mapping does not exist, then the character passed is returned.
* Note that isTitleCase(toTitleCase(ch)) does not always return true.
*
* @param ch character to convert to titlecase
* @return titlecase mapping of ch, or ch if titlecase mapping does
* not exist
* @see #isTitleCase(char)
* @see #toLowerCase(char)
* @see #toUpperCase(char)
*/
public static native char toTitleCase(char ch);
/**
* Converts a character into a digit of the specified radix. If the radix
* exceeds MIN_RADIX or MAX_RADIX, or if the result of getNumericValue(ch)
* exceeds the radix, or if ch is not a decimal digit or in the case
* insensitive set of 'a'-'z', the result is -1.
*
* character argument boundary = [Nd]|U+0041-U+005A|U+0061-U+007A
* |U+FF21-U+FF3A|U+FF41-U+FF5A
*
* @param ch character to convert into a digit
* @param radix radix in which ch is a digit
* @return digit which ch represents in radix, or -1 not a valid digit
* @see #MIN_RADIX
* @see #MAX_RADIX
* @see #forDigit(int, int)
* @see #isDigit(char)
* @see #getNumericValue(char)
*/
public static native int digit(char ch, int radix);
/**
* Returns the Unicode numeric value property of a character. For example,
* '\\u216C' (the Roman numeral fifty) returns 50.
*
*
This method also returns values for the letters A through Z, (not
* specified by Unicode), in these ranges: '\u0041'
* through '\u005A' (uppercase); '\u0061'
* through '\u007A' (lowercase); and '\uFF21'
* through '\uFF3A', '\uFF41' through
* '\uFF5A' (full width variants).
*
*
If the character lacks a numeric value property, -1 is returned.
* If the character has a numeric value property which is not representable
* as a nonnegative integer, such as a fraction, -2 is returned.
*
* character argument boundary = [Nd]|[Nl]|[No]|U+0041-U+005A|U+0061-U+007A
* |U+FF21-U+FF3A|U+FF41-U+FF5A
*
* @param ch character from which the numeric value property will
* be retrieved
* @return the numeric value property of ch, or -1 if it does not exist, or
* -2 if it is not representable as a nonnegative integer
* @see #forDigit(int, int)
* @see #digit(char, int)
* @see #isDigit(char)
* @since 1.1
*/
public static native int getNumericValue(char ch);
/**
* Determines if a character is a ISO-LATIN-1 space. This is only the five
* characters '\t', '\n', '\f',
* '\r', and ' '.
*
* Java space = U+0020|U+0009|U+000A|U+000C|U+000D
*
* @param ch character to test
* @return true if ch is a space, else false
* @deprecated Replaced by {@link #isWhitespace(char)}
* @see #isSpaceChar(char)
* @see #isWhitespace(char)
*/
public static boolean isSpace(char ch)
{
// Performing the subtraction up front alleviates need to compare longs.
return ch-- <= ' ' && ((1 << ch)
& ((1 << (' ' - 1))
| (1 << ('\t' - 1))
| (1 << ('\n' - 1))
| (1 << ('\r' - 1))
| (1 << ('\f' - 1)))) != 0;
}
/**
* Determines if a character is a Unicode space character. This includes
* SPACE_SEPARATOR, LINE_SEPARATOR, and PARAGRAPH_SEPARATOR.
*
* Unicode space = [Zs]|[Zp]|[Zl]
*
* @param ch character to test
* @return true if ch is a Unicode space, else false
* @see #isWhitespace(char)
* @since 1.1
*/
public static boolean isSpaceChar(char ch)
{
return ((1 << getType(ch))
& ((1 << SPACE_SEPARATOR)
| (1 << LINE_SEPARATOR)
| (1 << PARAGRAPH_SEPARATOR))) != 0;
}
/**
* Determines if a character is Java whitespace. This includes Unicode
* space characters (SPACE_SEPARATOR, LINE_SEPARATOR, and
* PARAGRAPH_SEPARATOR) except the non-breaking spaces
* ('\u00A0', '\u2007', and '\u202F');
* and these characters: '\u0009', '\u000A',
* '\u000B', '\u000C', '\u000D',
* '\u001C', '\u001D', '\u001E',
* and '\u001F'.
*
* Java whitespace = ([Zs] not Nb)|[Zl]|[Zp]|U+0009-U+000D|U+001C-U+001F
*
* @param ch character to test
* @return true if ch is Java whitespace, else false
* @see #isSpaceChar(char)
* @since 1.1
*/
public static boolean isWhitespace(char ch)
{
int attr = readChar(ch);
return ((((1 << (attr & TYPE_MASK))
& ((1 << SPACE_SEPARATOR)
| (1 << LINE_SEPARATOR)
| (1 << PARAGRAPH_SEPARATOR))) != 0)
&& (attr & NO_BREAK_MASK) == 0)
|| (ch <= '\u001F' && ((1 << ch)
& ((1 << '\t')
| (1 << '\n')
| (1 << '\u000B')
| (1 << '\u000C')
| (1 << '\r')
| (1 << '\u001C')
| (1 << '\u001D')
| (1 << '\u001E')
| (1 << '\u001F'))) != 0);
}
/**
* Determines if a character has the ISO Control property.
*
* ISO Control = [Cc]
*
* @param ch character to test
* @return true if ch is an ISO Control character, else false
* @see #isSpaceChar(char)
* @see #isWhitespace(char)
* @since 1.1
*/
public static boolean isISOControl(char ch)
{
return getType(ch) == CONTROL;
}
/**
* Returns the Unicode general category property of a character.
*
* @param ch character from which the general category property will
* be retrieved
* @return the character category property of ch as an integer
* @see #UNASSIGNED
* @see #UPPERCASE_LETTER
* @see #LOWERCASE_LETTER
* @see #TITLECASE_LETTER
* @see #MODIFIER_LETTER
* @see #OTHER_LETTER
* @see #NON_SPACING_MARK
* @see #ENCLOSING_MARK
* @see #COMBINING_SPACING_MARK
* @see #DECIMAL_DIGIT_NUMBER
* @see #LETTER_NUMBER
* @see #OTHER_NUMBER
* @see #SPACE_SEPARATOR
* @see #LINE_SEPARATOR
* @see #PARAGRAPH_SEPARATOR
* @see #CONTROL
* @see #FORMAT
* @see #PRIVATE_USE
* @see #SURROGATE
* @see #DASH_PUNCTUATION
* @see #START_PUNCTUATION
* @see #END_PUNCTUATION
* @see #CONNECTOR_PUNCTUATION
* @see #OTHER_PUNCTUATION
* @see #MATH_SYMBOL
* @see #CURRENCY_SYMBOL
* @see #MODIFIER_SYMBOL
* @see #INITIAL_QUOTE_PUNCTUATION
* @see #FINAL_QUOTE_PUNCTUATION
* @since 1.1
*/
public static native int getType(char ch);
/**
* Converts a digit into a character which represents that digit
* in a specified radix. If the radix exceeds MIN_RADIX or MAX_RADIX,
* or the digit exceeds the radix, then the null character '\0'
* is returned. Otherwise the return value is in '0'-'9' and 'a'-'z'.
*
* return value boundary = U+0030-U+0039|U+0061-U+007A
*
* @param digit digit to be converted into a character
* @param radix radix of digit
* @return character representing digit in radix, or '\0'
* @see #MIN_RADIX
* @see #MAX_RADIX
* @see #digit(char, int)
*/
public static char forDigit(int digit, int radix)
{
if (radix < MIN_RADIX || radix > MAX_RADIX
|| digit < 0 || digit >= radix)
return '\0';
return (char) (digit < 10 ? ('0' + digit) : ('a' - 10 + digit));
}
/**
* Returns the Unicode directionality property of the character. This
* is used in the visual ordering of text.
*
* @param ch the character to look up
* @return the directionality constant, or DIRECTIONALITY_UNDEFINED
* @see #DIRECTIONALITY_UNDEFINED
* @see #DIRECTIONALITY_LEFT_TO_RIGHT
* @see #DIRECTIONALITY_RIGHT_TO_LEFT
* @see #DIRECTIONALITY_RIGHT_TO_LEFT_ARABIC
* @see #DIRECTIONALITY_EUROPEAN_NUMBER
* @see #DIRECTIONALITY_EUROPEAN_NUMBER_SEPARATOR
* @see #DIRECTIONALITY_EUROPEAN_NUMBER_TERMINATOR
* @see #DIRECTIONALITY_ARABIC_NUMBER
* @see #DIRECTIONALITY_COMMON_NUMBER_SEPARATOR
* @see #DIRECTIONALITY_NONSPACING_MARK
* @see #DIRECTIONALITY_BOUNDARY_NEUTRAL
* @see #DIRECTIONALITY_PARAGRAPH_SEPARATOR
* @see #DIRECTIONALITY_SEGMENT_SEPARATOR
* @see #DIRECTIONALITY_WHITESPACE
* @see #DIRECTIONALITY_OTHER_NEUTRALS
* @see #DIRECTIONALITY_LEFT_TO_RIGHT_EMBEDDING
* @see #DIRECTIONALITY_LEFT_TO_RIGHT_OVERRIDE
* @see #DIRECTIONALITY_RIGHT_TO_LEFT_EMBEDDING
* @see #DIRECTIONALITY_RIGHT_TO_LEFT_OVERRIDE
* @see #DIRECTIONALITY_POP_DIRECTIONAL_FORMAT
* @since 1.4
*/
public static native byte getDirectionality(char ch);
/**
* Determines whether the character is mirrored according to Unicode. For
* example, \u0028 (LEFT PARENTHESIS) appears as '(' in
* left-to-right text, but ')' in right-to-left text.
*
* @param ch the character to look up
* @return true if the character is mirrored
* @since 1.4
*/
public static boolean isMirrored(char ch)
{
return (readChar(ch) & MIRROR_MASK) != 0;
}
/**
* Compares another Character to this Character, numerically.
*
* @param anotherCharacter Character to compare with this Character
* @return a negative integer if this Character is less than
* anotherCharacter, zero if this Character is equal, and
* a positive integer if this Character is greater
* @throws NullPointerException if anotherCharacter is null
* @since 1.2
*/
public int compareTo(Character anotherCharacter)
{
return value - anotherCharacter.value;
}
/**
* Compares an object to this Character. Assuming the object is a
* Character object, this method performs the same comparison as
* compareTo(Character).
*
* @param o object to compare
* @return the comparison value
* @throws ClassCastException if o is not a Character object
* @throws NullPointerException if o is null
* @see #compareTo(Character)
* @since 1.2
*/
public int compareTo(Object o)
{
return compareTo((Character) o);
}
} // class Character