UCharacter (icu4j)

Overview

Package

Class

Use

Tree

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.ibm.icu.lang
Class UCharacter

java.lang.Object
  com.ibm.icu.lang.UCharacter

All Implemented Interfaces:: UCharacterEnums.ECharacterCategory, UCharacterEnums.ECharacterDirection

public final class UCharacter
extends Object
implements UCharacterEnums.ECharacterCategory, UCharacterEnums.ECharacterDirection
extends Object
implements UCharacterEnums.ECharacterCategory, UCharacterEnums.ECharacterDirection

The UCharacter class provides extensions to the java.lang.Character class. These extensions provide support for more Unicode properties and together with the UTF16 class, provide support for supplementary characters (those with code points above U+FFFF). Each ICU release supports the latest version of Unicode available at that time.

Code points are represented in these API using ints. While it would be more convenient in Java to have a separate primitive datatype for them, ints suffice in the meantime.

To use this class please add the jar file name icu4j.jar to the class path, since it contains data files which supply the information used by this file.
E.g. In Windows
set CLASSPATH=%CLASSPATH%;$JAR_FILE_PATH/ucharacter.jar.
Otherwise, another method would be to copy the files uprops.dat and unames.icu from the icu4j source subdirectory $ICU4J_SRC/src/com.ibm.icu.impl.data to your class directory $ICU4J_CLASS/com.ibm.icu.impl.data.

Aside from the additions for UTF-16 support, and the updated Unicode properties, the main differences between UCharacter and Character are:

UCharacter is not designed to be a char wrapper and does not have APIs to which involves management of that single char.
These include:
- char charValue(),
- int compareTo(java.lang.Character, java.lang.Character), etc.
UCharacter does not include Character APIs that are deprecated, nor does it include the Java-specific character information, such as boolean isJavaIdentifierPart(char ch).
Character maps characters 'A' - 'Z' and 'a' - 'z' to the numeric values '10' - '35'. UCharacter also does this in digit and getNumericValue, to adhere to the java semantics of these methods. New methods unicodeDigit, and getUnicodeNumericValue do not treat the above code points as having numeric values. This is a semantic change from ICU4J 1.3.1.

Further detail differences can be determined from the program com.ibm.icu.dev.test.lang.UCharacterCompare

In addition to Java compatibility functions, which calculate derived properties, this API provides low-level access to the Unicode Character Database.

Unicode assigns each code point (not just assigned character) values for many properties. Most of them are simple boolean flags, or constants from a small enumerated list. For some properties, values are strings or other relatively more complex types.

For more information see "About the Unicode Character Database" (http://www.unicode.org/ucd/) and the ICU User Guide chapter on Properties (http://www.icu-project.org/userguide/properties.html).

There are also functions that provide easy migration from C/POSIX functions like isblank(). Their use is generally discouraged because the C/POSIX standards do not define their semantics beyond the ASCII range, which means that different implementations exhibit very different behavior. Instead, Unicode properties should be used directly.

There are also only a few, broad C/POSIX character classes, and they tend to be used for conflicting purposes. For example, the "isalpha()" class is sometimes used to determine word boundaries, while a more sophisticated approach would at least distinguish initial letters from continuation characters (the latter including combining marks). (In ICU, BreakIterator is the most sophisticated API for word boundaries.) Another example: There is no "istitle()" class for titlecase characters.

ICU 3.4 and later provides API access for all twelve C/POSIX character classes. ICU implements them according to the Standard Recommendations in Annex C: Compatibility Properties of UTS #18 Unicode Regular Expressions (http://www.unicode.org/reports/tr18/#Compatibility_Properties).

API access for C/POSIX character classes is as follows: - alpha: isUAlphabetic(c) or hasBinaryProperty(c, UProperty.ALPHABETIC) - lower: isULowercase(c) or hasBinaryProperty(c, UProperty.LOWERCASE) - upper: isUUppercase(c) or hasBinaryProperty(c, UProperty.UPPERCASE) - punct: ((1<

The C/POSIX character classes are also available in UnicodeSet patterns, using patterns like [:graph:] or \p{graph}.

Note: There are several ICU (and Java) whitespace functions. Comparison: - isUWhiteSpace=UCHAR_WHITE_SPACE: Unicode White_Space property; most of general categories "Z" (separators) + most whitespace ISO controls (including no-break spaces, but excluding IS1..IS4 and ZWSP) - isWhitespace: Java isWhitespace; Z + whitespace ISO controls but excluding no-break spaces - isSpaceChar: just Z (including no-break spaces)

This class is not subclassable

Author:: Syn Wee Quek
See Also:: UCharacterEnums
Status:: Stable ICU 2.1.

Nested Class Summary
`static interface`	`UCharacter.DecompositionType` Decomposition Type constants.
`static interface`	`UCharacter.EastAsianWidth` East Asian Width constants.
`static interface`	`UCharacter.GraphemeClusterBreak` Grapheme Cluster Break constants.
`static interface`	`UCharacter.HangulSyllableType` Hangul Syllable Type constants.
`static interface`	`UCharacter.JoiningGroup` Joining Group constants.
`static interface`	`UCharacter.JoiningType` Joining Type constants.
`static interface`	`UCharacter.LineBreak` Line Break constants.
`static interface`	`UCharacter.NumericType` Numeric Type constants.
`static interface`	`UCharacter.SentenceBreak` Sentence Break constants.
`static class`	`UCharacter.UnicodeBlock` A family of character subsets representing the character blocks in the Unicode specification, generated from Unicode Data file Blocks.txt.
`static interface`	`UCharacter.WordBreak` Word Break constants.

Field Summary
`static int`	`FOLD_CASE_DEFAULT` Option value for case folding: use default mappings defined in CaseFolding.txt.
`static int`	`FOLD_CASE_EXCLUDE_SPECIAL_I` Option value for case folding: exclude the mappings for dotted I and dotless i marked with 'I' in CaseFolding.txt.
`static int`	`MAX_CODE_POINT` Cover the JDK 1.5 API, for convenience.
`static char`	`MAX_HIGH_SURROGATE` Cover the JDK 1.5 API, for convenience.
`static char`	`MAX_LOW_SURROGATE` Cover the JDK 1.5 API, for convenience.
`static int`	`MAX_RADIX` Compatibility constant for Java Character's MAX_RADIX.
`static char`	`MAX_SURROGATE` Cover the JDK 1.5 API, for convenience.
`static int`	`MAX_VALUE` The highest Unicode code point value (scalar value) according to the Unicode Standard.
`static int`	`MIN_CODE_POINT` Cover the JDK 1.5 API, for convenience.
`static char`	`MIN_HIGH_SURROGATE` Cover the JDK 1.5 API, for convenience.
`static char`	`MIN_LOW_SURROGATE` Cover the JDK 1.5 API, for convenience.
`static int`	`MIN_RADIX` Compatibility constant for Java Character's MIN_RADIX.
`static int`	`MIN_SUPPLEMENTARY_CODE_POINT` Cover the JDK 1.5 API, for convenience.
`static char`	`MIN_SURROGATE` Cover the JDK 1.5 API, for convenience.
`static int`	`MIN_VALUE` The lowest Unicode code point value.
`static double`	`NO_NUMERIC_VALUE` Special value that is returned by getUnicodeNumericValue(int) when no numeric value is defined for a code point.
`static int`	`REPLACEMENT_CHAR` Unicode value used when translating into Unicode encoding form and there is no existing character.
`static int`	`SUPPLEMENTARY_MIN_VALUE` The minimum value for Supplementary code points
`static int`	`TITLECASE_NO_BREAK_ADJUSTMENT` Do not adjust the titlecasing indexes from BreakIterator::next() indexes; titlecase exactly the characters at breaks from the iterator.
`static int`	`TITLECASE_NO_LOWERCASE` Do not lowercase non-initial parts of words when titlecasing.

Fields inherited from interface com.ibm.icu.lang.UCharacterEnums.ECharacterCategory
CHAR_CATEGORY_COUNT, COMBINING_SPACING_MARK, CONNECTOR_PUNCTUATION, CONTROL, CURRENCY_SYMBOL, DASH_PUNCTUATION, DECIMAL_DIGIT_NUMBER, ENCLOSING_MARK, END_PUNCTUATION, FINAL_PUNCTUATION, FINAL_QUOTE_PUNCTUATION, FORMAT, GENERAL_OTHER_TYPES, INITIAL_PUNCTUATION, INITIAL_QUOTE_PUNCTUATION, LETTER_NUMBER, LINE_SEPARATOR, LOWERCASE_LETTER, MATH_SYMBOL, MODIFIER_LETTER, MODIFIER_SYMBOL, NON_SPACING_MARK, OTHER_LETTER, OTHER_NUMBER, OTHER_PUNCTUATION, OTHER_SYMBOL, PARAGRAPH_SEPARATOR, PRIVATE_USE, SPACE_SEPARATOR, START_PUNCTUATION, SURROGATE, TITLECASE_LETTER, UNASSIGNED, UPPERCASE_LETTER

Fields inherited from interface com.ibm.icu.lang.UCharacterEnums.ECharacterCategory

CHAR_CATEGORY_COUNT, COMBINING_SPACING_MARK, CONNECTOR_PUNCTUATION, CONTROL, CURRENCY_SYMBOL, DASH_PUNCTUATION, DECIMAL_DIGIT_NUMBER, ENCLOSING_MARK, END_PUNCTUATION, FINAL_PUNCTUATION, FINAL_QUOTE_PUNCTUATION, FORMAT, GENERAL_OTHER_TYPES, INITIAL_PUNCTUATION, INITIAL_QUOTE_PUNCTUATION, LETTER_NUMBER, LINE_SEPARATOR, LOWERCASE_LETTER, MATH_SYMBOL, MODIFIER_LETTER, MODIFIER_SYMBOL, NON_SPACING_MARK, OTHER_LETTER, OTHER_NUMBER, OTHER_PUNCTUATION, OTHER_SYMBOL, PARAGRAPH_SEPARATOR, PRIVATE_USE, SPACE_SEPARATOR, START_PUNCTUATION, SURROGATE, TITLECASE_LETTER, UNASSIGNED, UPPERCASE_LETTER

Fields inherited from interface com.ibm.icu.lang.UCharacterEnums.ECharacterDirection
ARABIC_NUMBER, BLOCK_SEPARATOR, BOUNDARY_NEUTRAL, CHAR_DIRECTION_COUNT, COMMON_NUMBER_SEPARATOR, DIR_NON_SPACING_MARK, DIRECTIONALITY_ARABIC_NUMBER, DIRECTIONALITY_BOUNDARY_NEUTRAL, DIRECTIONALITY_COMMON_NUMBER_SEPARATOR, DIRECTIONALITY_EUROPEAN_NUMBER, DIRECTIONALITY_EUROPEAN_NUMBER_SEPARATOR, DIRECTIONALITY_EUROPEAN_NUMBER_TERMINATOR, DIRECTIONALITY_LEFT_TO_RIGHT, DIRECTIONALITY_LEFT_TO_RIGHT_EMBEDDING, DIRECTIONALITY_LEFT_TO_RIGHT_OVERRIDE, DIRECTIONALITY_NONSPACING_MARK, DIRECTIONALITY_OTHER_NEUTRALS, DIRECTIONALITY_PARAGRAPH_SEPARATOR, DIRECTIONALITY_POP_DIRECTIONAL_FORMAT, DIRECTIONALITY_RIGHT_TO_LEFT, DIRECTIONALITY_RIGHT_TO_LEFT_ARABIC, DIRECTIONALITY_RIGHT_TO_LEFT_EMBEDDING, DIRECTIONALITY_RIGHT_TO_LEFT_OVERRIDE, DIRECTIONALITY_SEGMENT_SEPARATOR, DIRECTIONALITY_UNDEFINED, DIRECTIONALITY_WHITESPACE, EUROPEAN_NUMBER, EUROPEAN_NUMBER_SEPARATOR, EUROPEAN_NUMBER_TERMINATOR, LEFT_TO_RIGHT, LEFT_TO_RIGHT_EMBEDDING, LEFT_TO_RIGHT_OVERRIDE, OTHER_NEUTRAL, POP_DIRECTIONAL_FORMAT, RIGHT_TO_LEFT, RIGHT_TO_LEFT_ARABIC, RIGHT_TO_LEFT_EMBEDDING, RIGHT_TO_LEFT_OVERRIDE, SEGMENT_SEPARATOR, WHITE_SPACE_NEUTRAL

Fields inherited from interface com.ibm.icu.lang.UCharacterEnums.ECharacterDirection

ARABIC_NUMBER, BLOCK_SEPARATOR, BOUNDARY_NEUTRAL, CHAR_DIRECTION_COUNT, COMMON_NUMBER_SEPARATOR, DIR_NON_SPACING_MARK, DIRECTIONALITY_ARABIC_NUMBER, DIRECTIONALITY_BOUNDARY_NEUTRAL, DIRECTIONALITY_COMMON_NUMBER_SEPARATOR, DIRECTIONALITY_EUROPEAN_NUMBER, DIRECTIONALITY_EUROPEAN_NUMBER_SEPARATOR, DIRECTIONALITY_EUROPEAN_NUMBER_TERMINATOR, DIRECTIONALITY_LEFT_TO_RIGHT, DIRECTIONALITY_LEFT_TO_RIGHT_EMBEDDING, DIRECTIONALITY_LEFT_TO_RIGHT_OVERRIDE, DIRECTIONALITY_NONSPACING_MARK, DIRECTIONALITY_OTHER_NEUTRALS, DIRECTIONALITY_PARAGRAPH_SEPARATOR, DIRECTIONALITY_POP_DIRECTIONAL_FORMAT, DIRECTIONALITY_RIGHT_TO_LEFT, DIRECTIONALITY_RIGHT_TO_LEFT_ARABIC, DIRECTIONALITY_RIGHT_TO_LEFT_EMBEDDING, DIRECTIONALITY_RIGHT_TO_LEFT_OVERRIDE, DIRECTIONALITY_SEGMENT_SEPARATOR, DIRECTIONALITY_UNDEFINED, DIRECTIONALITY_WHITESPACE, EUROPEAN_NUMBER, EUROPEAN_NUMBER_SEPARATOR, EUROPEAN_NUMBER_TERMINATOR, LEFT_TO_RIGHT, LEFT_TO_RIGHT_EMBEDDING, LEFT_TO_RIGHT_OVERRIDE, OTHER_NEUTRAL, POP_DIRECTIONAL_FORMAT, RIGHT_TO_LEFT, RIGHT_TO_LEFT_ARABIC, RIGHT_TO_LEFT_EMBEDDING, RIGHT_TO_LEFT_OVERRIDE, SEGMENT_SEPARATOR, WHITE_SPACE_NEUTRAL

Method Summary
`static int`	`charCount(int cp)` Cover the JDK 1.5 API, for convenience.
`static int`	`codePointAt(char[] text, int index)` Cover the JDK 1.5 API, for convenience.
`static int`	`codePointAt(char[] text, int index, int limit)` Cover the JDK 1.5 API, for convenience.
`static int`	`codePointAt(CharSequence seq, int index)` Cover the JDK 1.5 API, for convenience.
`static int`	`codePointBefore(char[] text, int index)` Cover the JDK 1.5 API, for convenience.
`static int`	`codePointBefore(char[] text, int index, int limit)` Cover the JDK 1.5 API, for convenience.
`static int`	`codePointBefore(CharSequence seq, int index)` Cover the JDK 1.5 API, for convenience.
`static int`	`codePointCount(char[] text, int start, int limit)` Cover the JDK API, for convenience.
`static int`	`codePointCount(CharSequence text, int start, int limit)` Cover the JDK API, for convenience.
`static int`	`digit(int ch)` Retrieves the numeric value of a decimal digit code point.
`static int`	`digit(int ch, int radix)` Retrieves the numeric value of a decimal digit code point.
`static int`	`foldCase(int ch, boolean defaultmapping)` The given character is mapped to its case folding equivalent according to UnicodeData.txt and CaseFolding.txt; if the character has no case folding equivalent, the character itself is returned.
`static int`	`foldCase(int ch, int options)` The given character is mapped to its case folding equivalent according to UnicodeData.txt and CaseFolding.txt; if the character has no case folding equivalent, the character itself is returned.
`static String`	`foldCase(String str, boolean defaultmapping)` The given string is mapped to its case folding equivalent according to UnicodeData.txt and CaseFolding.txt; if any character has no case folding equivalent, the character itself is returned.
`static String`	`foldCase(String str, int options)` The given string is mapped to its case folding equivalent according to UnicodeData.txt and CaseFolding.txt; if any character has no case folding equivalent, the character itself is returned.
`static char`	`forDigit(int digit, int radix)` Provide the java.lang.Character forDigit API, for convenience.
`static VersionInfo`	`getAge(int ch)` Get the "age" of the code point.
`static int`	`getCharFromExtendedName(String name)` Find a Unicode character by either its name and return its code point value.
`static int`	`getCharFromName(String name)` Find a Unicode code point by its most current Unicode name and return its code point value.
`static int`	`getCharFromName1_0(String name)` Find a Unicode character by its version 1.0 Unicode name and return its code point value.
`static int`	`getCodePoint(char char16)` Returns the code point corresponding to the UTF16 character.
`static int`	`getCodePoint(char lead, char trail)` Returns a code point corresponding to the two UTF16 characters.
`static int`	`getCombiningClass(int ch)` Gets the combining class of the argument codepoint
`static int`	`getDirection(int ch)` Returns the Bidirection property of a code point.
`static byte`	`getDirectionality(int cp)` Cover the JDK API, for convenience.
`static String`	`getExtendedName(int ch)` Retrieves a name for a valid codepoint.
`static ValueIterator`	`getExtendedNameIterator()` Gets an iterator for character names, iterating over codepoints.
`static int`	`getHanNumericValue(int ch)` Return numeric value of Han code points.
`static int`	`getIntPropertyMaxValue(int type)` Get the maximum value for an integer/binary Unicode property.
`static int`	`getIntPropertyMinValue(int type)` Get the minimum value for an integer/binary Unicode property type.
`static int`	`getIntPropertyValue(int ch, int type)` Gets the property value for an Unicode property type of a code point.
`static String`	`getISOComment(int ch)` Get the ISO 10646 comment for a character.
`static int`	`getMirror(int ch)` Maps the specified code point to a "mirror-image" code point.
`static String`	`getName(int ch)` Retrieve the most current Unicode name of the argument code point, or null if the character is unassigned or outside the range UCharacter.MIN_VALUE and UCharacter.MAX_VALUE or does not have a name.
`static String`	`getName(String s, String separator)` Gets the names for each of the characters in a string
`static String`	`getName1_0(int ch)` Retrieve the earlier version 1.0 Unicode name of the argument code point, or null if the character is unassigned or outside the range UCharacter.MIN_VALUE and UCharacter.MAX_VALUE or does not have a name.
`static ValueIterator`	`getName1_0Iterator()` Gets an iterator for character names, iterating over codepoints.
`static ValueIterator`	`getNameIterator()` Gets an iterator for character names, iterating over codepoints.
`static int`	`getNumericValue(int ch)` Returns the numeric value of the code point as a nonnegative integer.
`static int`	`getPropertyEnum(String propertyAlias)` Return the UProperty selector for a given property name, as specified in the Unicode database file PropertyAliases.txt.
`static String`	`getPropertyName(int property, int nameChoice)` Return the Unicode name for a given property, as given in the Unicode database file PropertyAliases.txt.
`static int`	`getPropertyValueEnum(int property, String valueAlias)` Return the property value integer for a given value name, as specified in the Unicode database file PropertyValueAliases.txt.
`static String`	`getPropertyValueName(int property, int value, int nameChoice)` Return the Unicode name for a given property value, as given in the Unicode database file PropertyValueAliases.txt.
`static String`	`getStringPropertyValue(int propertyEnum, int codepoint, int nameChoice)` Deprecated. This API is ICU internal only.
`static int`	`getType(int ch)` Returns a value indicating a code point's Unicode category.
`static RangeValueIterator`	`getTypeIterator()` Gets an iterator for character types, iterating over codepoints.
`static double`	`getUnicodeNumericValue(int ch)` Get the numeric value for a Unicode code point as defined in the Unicode Character Database.
`static VersionInfo`	`getUnicodeVersion()` Gets the version of Unicode data used.
`static boolean`	`hasBinaryProperty(int ch, int property)` Check a binary Unicode property for a code point.
`static boolean`	`isBaseForm(int ch)` Determines whether the specified code point is of base form.
`static boolean`	`isBMP(int ch)` Determines if the code point is in the BMP plane.
`static boolean`	`isDefined(int ch)` Determines if a code point has a defined meaning in the up-to-date Unicode standard.
`static boolean`	`isDigit(int ch)` Determines if a code point is a Java digit.
`static boolean`	`isHighSurrogate(char ch)` Cover the JDK 1.5 API, for convenience.
`static boolean`	`isIdentifierIgnorable(int ch)` Determines if the specified code point should be regarded as an ignorable character in a Unicode identifier.
`static boolean`	`isISOControl(int ch)` Determines if the specified code point is an ISO control character.
`static boolean`	`isJavaIdentifierPart(int cp)` Compatibility override of Java method, delegates to java.lang.Character.isJavaIdentifierPart.
`static boolean`	`isJavaIdentifierStart(int cp)` Compatibility override of Java method, delegates to java.lang.Character.isJavaIdentifierStart.
`static boolean`	`isJavaLetter(int cp)` Deprecated. ICU 3.4 (Java)
`static boolean`	`isJavaLetterOrDigit(int cp)` Deprecated. ICU 3.4 (Java)
`static boolean`	`isLegal(int ch)` A code point is illegal if and only if Out of bounds, less than 0 or greater than UCharacter.MAX_VALUE A surrogate value, 0xD800 to 0xDFFF Not-a-character, having the form 0x xxFFFF or 0x xxFFFE Note: legal does not mean that it is assigned in this version of Unicode.
`static boolean`	`isLegal(String str)` A string is legal iff all its code points are legal.
`static boolean`	`isLetter(int ch)` Determines if the specified code point is a letter.
`static boolean`	`isLetterOrDigit(int ch)` Determines if the specified code point is a letter or digit.
`static boolean`	`isLowerCase(int ch)` Determines if the specified code point is a lowercase character.
`static boolean`	`isLowSurrogate(char ch)` Cover the JDK 1.5 API, for convenience.
`static boolean`	`isMirrored(int ch)` Determines whether the code point has the "mirrored" property.
`static boolean`	`isPrintable(int ch)` Determines whether the specified code point is a printable character according to the Unicode standard.
`static boolean`	`isSpace(int ch)` Deprecated. ICU 3.4 (Java)
`static boolean`	`isSpaceChar(int ch)` Determines if the specified code point is a Unicode specified space character, i.e. if code point is in the category Zs, Zl and Zp.
`static boolean`	`isSupplementary(int ch)` Determines if the code point is a supplementary character.
`static boolean`	`isSupplementaryCodePoint(int cp)` Cover the JDK 1.5 API, for convenience.
`static boolean`	`isSurrogatePair(char high, char low)` Cover the JDK 1.5 API, for convenience.
`static boolean`	`isTitleCase(int ch)` Determines if the specified code point is a titlecase character.
`static boolean`	`isUAlphabetic(int ch)` Check if a code point has the Alphabetic Unicode property.
`static boolean`	`isULowercase(int ch)` Check if a code point has the Lowercase Unicode property.
`static boolean`	`isUnicodeIdentifierPart(int ch)` Determines if the specified code point may be any part of a Unicode identifier other than the starting character.
`static boolean`	`isUnicodeIdentifierStart(int ch)` Determines if the specified code point is permissible as the first character in a Unicode identifier.
`static boolean`	`isUpperCase(int ch)` Determines if the specified code point is an uppercase character.
`static boolean`	`isUUppercase(int ch)` Check if a code point has the Uppercase Unicode property.
`static boolean`	`isUWhiteSpace(int ch)` Check if a code point has the White_Space Unicode property.
`static boolean`	`isValidCodePoint(int cp)` Cover the JDK 1.5 API, for convenience.
`static boolean`	`isWhitespace(int ch)` Determines if the specified code point is a white space character.
`static int`	`offsetByCodePoints(char[] text, int start, int count, int index, int codePointOffset)` Cover the JDK API, for convenience.
`static int`	`offsetByCodePoints(CharSequence text, int index, int codePointOffset)` Cover the JDK API, for convenience.
`static char[]`	`toChars(int cp)` Cover the JDK 1.5 API, for convenience.
`static int`	`toChars(int cp, char[] dst, int dstIndex)` Cover the JDK 1.5 API, for convenience.
`static int`	`toCodePoint(char high, char low)` Cover the JDK 1.5 API, for convenience.
`static int`	`toLowerCase(int ch)` The given code point is mapped to its lowercase equivalent; if the code point has no lowercase equivalent, the code point itself is returned.
`static String`	`toLowerCase(Locale locale, String str)` Gets lowercase version of the argument string.
`static String`	`toLowerCase(String str)` Gets lowercase version of the argument string.
`static String`	`toLowerCase(ULocale locale, String str)` Gets lowercase version of the argument string.
`static String`	`toString(int ch)` Converts argument code point and returns a String object representing the code point's value in UTF16 format.
`static int`	`toTitleCase(int ch)` Converts the code point argument to titlecase.
`static String`	`toTitleCase(Locale locale, String str, BreakIterator breakiter)` Gets the titlecase version of the argument string.
`static String`	`toTitleCase(String str, BreakIterator breakiter)` Gets the titlecase version of the argument string.
`static String`	`toTitleCase(ULocale locale, String str, BreakIterator titleIter)` Gets the titlecase version of the argument string.
`static String`	`toTitleCase(ULocale locale, String str, BreakIterator titleIter, int options)` Gets the titlecase version of the argument string.
`static int`	`toUpperCase(int ch)` Converts the character argument to uppercase.
`static String`	`toUpperCase(Locale locale, String str)` Gets uppercase version of the argument string.
`static String`	`toUpperCase(String str)` Gets uppercase version of the argument string.
`static String`	`toUpperCase(ULocale locale, String str)` Gets uppercase version of the argument string.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

MIN_VALUE

public static final int MIN_VALUE

The lowest Unicode code point value.

See Also:: Constant Field Values
Status:: Stable ICU 2.1.

MAX_VALUE

public static final int MAX_VALUE

The highest Unicode code point value (scalar value) according to the Unicode Standard. This is a 21-bit value (21 bits, rounded up).
Up-to-date Unicode implementation of java.lang.Character.MIN_VALUE

See Also:: Constant Field Values
Status:: Stable ICU 2.1.

SUPPLEMENTARY_MIN_VALUE

public static final int SUPPLEMENTARY_MIN_VALUE

The minimum value for Supplementary code points

See Also:: Constant Field Values
Status:: Stable ICU 2.1.

REPLACEMENT_CHAR

public static final int REPLACEMENT_CHAR

Unicode value used when translating into Unicode encoding form and there is no existing character.

See Also:: Constant Field Values
Status:: Stable ICU 2.1.

NO_NUMERIC_VALUE

public static final double NO_NUMERIC_VALUE

Special value that is returned by getUnicodeNumericValue(int) when no numeric value is defined for a code point.

See Also:: getUnicodeNumericValue(int), Constant Field Values
Status:: Stable ICU 2.4.

MIN_RADIX

public static final int MIN_RADIX

Compatibility constant for Java Character's MIN_RADIX.

See Also:: Constant Field Values
Status:: Stable ICU 3.4.

MAX_RADIX

public static final int MAX_RADIX

Compatibility constant for Java Character's MAX_RADIX.

See Also:: Constant Field Values
Status:: Stable ICU 3.4.

TITLECASE_NO_LOWERCASE

public static final int TITLECASE_NO_LOWERCASE

Do not lowercase non-initial parts of words when titlecasing. Option bit for titlecasing APIs that take an options bit set. By default, titlecasing will titlecase the first cased character of a word and lowercase all other characters. With this option, the other characters will not be modified.

See Also:: toTitleCase(int), Constant Field Values
Status:: Stable ICU 3.8.

TITLECASE_NO_BREAK_ADJUSTMENT

public static final int TITLECASE_NO_BREAK_ADJUSTMENT

Do not adjust the titlecasing indexes from BreakIterator::next() indexes; titlecase exactly the characters at breaks from the iterator. Option bit for titlecasing APIs that take an options bit set. By default, titlecasing will take each break iterator index, adjust it by looking for the next cased character, and titlecase that one. Other characters are lowercased. This follows Unicode 4 & 5 section 3.13 Default Case Operations: R3 toTitlecase(X): Find the word boundaries based on Unicode Standard Annex #29, "Text Boundaries." Between each pair of word boundaries, find the first cased character F. If F exists, map F to default_title(F); then map each subsequent character C to default_lower(C).

See Also:: toTitleCase(int), TITLECASE_NO_LOWERCASE, Constant Field Values
Status:: Stable ICU 3.8.

FOLD_CASE_DEFAULT

public static final int FOLD_CASE_DEFAULT

Option value for case folding: use default mappings defined in CaseFolding.txt.

See Also:: Constant Field Values
Status:: Stable ICU 2.6.

FOLD_CASE_EXCLUDE_SPECIAL_I

public static final int FOLD_CASE_EXCLUDE_SPECIAL_I

Option value for case folding: exclude the mappings for dotted I and dotless i marked with 'I' in CaseFolding.txt.

See Also:: Constant Field Values
Status:: Stable ICU 2.6.