|
FlexDoc/Javadoc 2.0 Demo Java Doc |
In addition, this class provides a large number of static methods for determining a character's category (lowercase letter, digit, etc.) and for converting characters from uppercase to lowercase and vice versa.
The fields and methods of class Character are defined in terms of character information from the Unicode Standard, specifically the UnicodeData file that is part of the Unicode Character Database. This file specifies properties including name and category for every assigned Unicode code point or character range. The file is available from the Unicode Consortium at http://www.unicode.org.
Character information is based on the Unicode Standard, version 13.0.
The Java platform has supported different versions of the Unicode Standard over time. Upgrades to newer versions of the Unicode Standard occurred in the following Java releases, each indicating the new version:
Java release | Unicode version |
---|---|
Java SE 15 | Unicode 13.0 |
Java SE 13 | Unicode 12.1 |
Java SE 12 | Unicode 11.0 |
Java SE 11 | Unicode 10.0 |
Java SE 9 | Unicode 8.0 |
Java SE 8 | Unicode 6.2 |
Java SE 7 | Unicode 6.0 |
Java SE 5.0 | Unicode 4.0 |
Java SE 1.4 | Unicode 3.0 |
JDK 1.1 | Unicode 2.0 |
JDK 1.0.2 | Unicode 1.1.5 |
The char data type (and therefore the value that a Character object encapsulates) are based on the original Unicode specification, which defined characters as fixed-width 16-bit entities. The Unicode Standard has since been changed to allow for characters whose representation requires more than 16 bits. The range of legal code points is now U+0000 to U+10FFFF, known as Unicode scalar value. (Refer to the definition of the U+n notation in the Unicode Standard.)
The set of characters from U+0000 to U+FFFF is sometimes referred to as the Basic Multilingual Plane (BMP). Characters whose code points are greater than U+FFFF are called supplementary characters. The Java platform uses the UTF-16 representation in char arrays and in the String and StringBuffer classes. In this representation, supplementary characters are represented as a pair of char values, the first from the high-surrogates range, (\uD800-\uDBFF), the second from the low-surrogates range (\uDC00-\uDFFF).
A char value, therefore, represents Basic Multilingual Plane (BMP) code points, including the surrogate code points, or code units of the UTF-16 encoding. An int value represents all Unicode code points, including supplementary code points. The lower (least significant) 21 bits of int are used to represent Unicode code points and the upper (most significant) 11 bits must be zero. Unless otherwise specified, the behavior with respect to supplementary characters and surrogate char values is as follows:
In the Java SE API documentation, Unicode code point is used for character values in the range between U+0000 and U+10FFFF, and Unicode code unit is used for 16-bit char values that are code units of the UTF-16 encoding. For more information on Unicode terminology, refer to the Unicode Glossary.
This is a value-based class; programmers should treat instances that are equal as interchangeable and should not use instances for synchronization, or unpredictable behavior may occur. For example, in a future release, synchronization may fail.
Nested Class Summary |
||
static class |
Instances of this class represent particular subsets of the Unicode
character set.
|
|
static class |
A family of character subsets representing the character blocks in the
Unicode specification.
|
|
static enum |
A family of character subsets representing the character scripts
defined in the
Unicode Standard Annex #24: Script Names.
|
Field Summary |
||
static final int |
The number of bytes used to represent a char value in unsigned
binary form.
|
|
static final byte |
General category "Mc" in the Unicode specification.
|
|
static final byte |
General category "Pc" in the Unicode specification.
|
|
static final byte |
General category "Cc" in the Unicode specification.
|
|
static final byte |
General category "Sc" in the Unicode specification.
|
|
static final byte |
General category "Pd" in the Unicode specification.
|
|
static final byte |
General category "Nd" in the Unicode specification.
|
|
static final byte |
Weak bidirectional character type "AN" in the Unicode specification.
|
|
static final byte |
Weak bidirectional character type "BN" in the Unicode specification.
|
|
static final byte |
Weak bidirectional character type "CS" in the Unicode specification.
|
|
static final byte |
Weak bidirectional character type "EN" in the Unicode specification.
|
|
static final byte |
Weak bidirectional character type "ES" in the Unicode specification.
|
|
static final byte |
Weak bidirectional character type "ET" in the Unicode specification.
|
|
static final byte |
Weak bidirectional character type "FSI" in the Unicode specification.
|
|
static final byte |
Strong bidirectional character type "L" in the Unicode specification.
|
|
static final byte |
Strong bidirectional character type "LRE" in the Unicode specification.
|
|
static final byte |
Weak bidirectional character type "LRI" in the Unicode specification.
|
|
static final byte |
Strong bidirectional character type "LRO" in the Unicode specification.
|
|
static final byte |
Weak bidirectional character type "NSM" in the Unicode specification.
|
|
static final byte |
Neutral bidirectional character type "ON" in the Unicode specification.
|
|
static final byte |
Neutral bidirectional character type "B" in the Unicode specification.
|
|
static final byte |
Weak bidirectional character type "PDF" in the Unicode specification.
|
|
static final byte |
Weak bidirectional character type "PDI" in the Unicode specification.
|
|
static final byte |
Strong bidirectional character type "R" in the Unicode specification.
|
|
static final byte |
Strong bidirectional character type "AL" in the Unicode specification.
|
|
static final byte |
Strong bidirectional character type "RLE" in the Unicode specification.
|
|
static final byte |
Weak bidirectional character type "RLI" in the Unicode specification.
|
|
static final byte |
Strong bidirectional character type "RLO" in the Unicode specification.
|
|
static final byte |
Neutral bidirectional character type "S" in the Unicode specification.
|
|
static final byte |
Undefined bidirectional character type.
|
|
static final byte |
Neutral bidirectional character type "WS" in the Unicode specification.
|
|
static final byte |
General category "Me" in the Unicode specification.
|
|
static final byte |
General category "Pe" in the Unicode specification.
|
|
static final byte |
General category "Pf" in the Unicode specification.
|
|
static final byte |
General category "Cf" in the Unicode specification.
|
|
static final byte |
General category "Pi" in the Unicode specification.
|
|
static final byte |
General category "Nl" in the Unicode specification.
|
|
static final byte |
General category "Zl" in the Unicode specification.
|
|
static final byte |
General category "Ll" in the Unicode specification.
|
|
static final byte |
General category "Sm" in the Unicode specification.
|
|
static final int |
The maximum value of a
Unicode code point, constant U+10FFFF.
|
|
static final char |
The maximum value of a
Unicode high-surrogate code unit
in the UTF-16 encoding, constant '\uDBFF'.
|
|
static final char |
The maximum value of a
Unicode low-surrogate code unit
in the UTF-16 encoding, constant '\uDFFF'.
|
|
static final int |
The maximum radix available for conversion to and from strings.
|
|
static final char |
The maximum value of a Unicode surrogate code unit in the
UTF-16 encoding, constant '\uDFFF'.
|
|
static final char |
The constant value of this field is the largest value of type
char, '\uFFFF'.
|
|
static final int |
The minimum value of a
Unicode code point, constant U+0000.
|
|
static final char |
The minimum value of a
Unicode high-surrogate code unit
in the UTF-16 encoding, constant '\uD800'.
|
|
static final char |
The minimum value of a
Unicode low-surrogate code unit
in the UTF-16 encoding, constant '\uDC00'.
|
|
static final int |
The minimum radix available for conversion to and from strings.
|
|
static final int |
The minimum value of a
Unicode supplementary code point, constant U+10000.
|
|
static final char |
The minimum value of a Unicode surrogate code unit in the
UTF-16 encoding, constant '\uD800'.
|
|
static final char |
The constant value of this field is the smallest value of type
char, '\u0000'.
|
|
static final byte |
General category "Lm" in the Unicode specification.
|
|
static final byte |
General category "Sk" in the Unicode specification.
|
|
static final byte |
General category "Mn" in the Unicode specification.
|
|
static final byte |
General category "Lo" in the Unicode specification.
|
|
static final byte |
General category "No" in the Unicode specification.
|
|
static final byte |
General category "Po" in the Unicode specification.
|
|
static final byte |
General category "So" in the Unicode specification.
|
|
static final byte |
General category "Zp" in the Unicode specification.
|
|
static final byte |
General category "Co" in the Unicode specification.
|
|
static final int |
The number of bits used to represent a char value in unsigned
binary form, constant 16.
|
|
static final byte |
General category "Zs" in the Unicode specification.
|
|
static final byte |
General category "Ps" in the Unicode specification.
|
|
static final byte |
General category "Cs" in the Unicode specification.
|
|
static final byte |
General category "Lt" in the Unicode specification.
|
|
The Class instance representing the primitive type
char.
|
||
static final byte |
General category "Cn" in the Unicode specification.
|
|
static final byte |
General category "Lu" in the Unicode specification.
|
Constructor Summary |
||
Character(char value)
Deprecated, for removal. It is rarely appropriate to use this constructor.
|
Method Summary |
||
static int |
charCount(int codePoint)
Determines the number of char values needed to
represent the specified character (Unicode code point).
|
|
char |
Returns the value of this Character object.
|
|
static int |
codePointAt(char[] a, int index)
Returns the code point at the given index of the
char array.
|
|
static int |
codePointAt(char[] a, int index, int limit)
Returns the code point at the given index of the
char array, where only array elements with
index less than limit can be used.
|
|
static int |
codePointAt(CharSequence seq, int index)
Returns the code point at the given index of the
CharSequence.
|
|
static int |
codePointBefore(char[] a, int index)
Returns the code point preceding the given index of the
char array.
|
|
static int |
codePointBefore(char[] a, int index, int start)
Returns the code point preceding the given index of the
char array, where only array elements with
index greater than or equal to start
can be used.
|
|
static int |
codePointBefore(CharSequence seq, int index)
Returns the code point preceding the given index of the
CharSequence.
|
|
static int |
codePointCount(char[] a, int offset, int count)
Returns the number of Unicode code points in a subarray of the
char array argument.
|
|
static int |
codePointCount(CharSequence seq, int beginIndex, int endIndex)
Returns the number of Unicode code points in the text range of
the specified char sequence.
|
|
static int |
codePointOf(String name)
Returns the code point value of the Unicode character specified by
the given Unicode character name.
|
|
static int |
compare(char x, char y)
Compares two char values numerically.
|
|
int |
Compares two Character objects numerically.
|
|
Returns an Optional containing the nominal descriptor for this
instance.
|
||
static int |
digit(char ch, int radix)
Returns the numeric value of the character ch in the
specified radix.
|
|
static int |
digit(int codePoint, int radix)
Returns the numeric value of the specified character (Unicode
code point) in the specified radix.
|
|
boolean |
Compares this object against the specified object.
|
|
static char |
forDigit(int digit, int radix)
Determines the character representation for a specific digit in
the specified radix.
|
|
static byte |
getDirectionality(char ch)
Returns the Unicode directionality property for the given
character.
|
|
static byte |
getDirectionality(int codePoint)
Returns the Unicode directionality property for the given
character (Unicode code point).
|
|
static String |
getName(int codePoint)
Returns the Unicode name of the specified character
codePoint, or null if the code point is
unassigned.
|
|
static int |
getNumericValue(char ch)
Returns the int value that the specified Unicode
character represents.
|
|
static int |
getNumericValue(int codePoint)
Returns the int value that the specified
character (Unicode code point) represents.
|
|
static int |
getType(char ch)
Returns a value indicating a character's general category.
|
|
static int |
getType(int codePoint)
Returns a value indicating a character's general category.
|
|
int |
hashCode()
Returns a hash code for this Character; equal to the result
of invoking charValue().
|
|
static int |
hashCode(char value)
Returns a hash code for a char value; compatible with
Character.hashCode().
|
|
static char |
highSurrogate(int codePoint)
Returns the leading surrogate (a
high surrogate code unit) of the
surrogate pair
representing the specified supplementary character (Unicode
code point) in the UTF-16 encoding.
|
|
static boolean |
isAlphabetic(int codePoint)
Determines if the specified character (Unicode code point) is alphabetic.
|
|
static boolean |
isBmpCodePoint(int codePoint)
Determines whether the specified character (Unicode code point)
is in the Basic Multilingual Plane (BMP).
|
|
static boolean |
isDefined(char ch)
Determines if a character is defined in Unicode.
|
|
static boolean |
isDefined(int codePoint)
Determines if a character (Unicode code point) is defined in Unicode.
|
|
static boolean |
isDigit(char ch)
Determines if the specified character is a digit.
|
|
static boolean |
isDigit(int codePoint)
Determines if the specified character (Unicode code point) is a digit.
|
|
static boolean |
isHighSurrogate(char ch)
Determines if the given char value is a
Unicode high-surrogate code unit
(also known as leading-surrogate code unit).
|
|
static boolean |
isIdentifierIgnorable(char ch)
Determines if the specified character should be regarded as
an ignorable character in a Java identifier or a Unicode identifier.
|
|
static boolean |
isIdentifierIgnorable(int codePoint)
Determines if the specified character (Unicode code point) should be regarded as
an ignorable character in a Java identifier or a Unicode identifier.
|
|
static boolean |
isIdeographic(int codePoint)
Determines if the specified character (Unicode code point) is a CJKV
(Chinese, Japanese, Korean and Vietnamese) ideograph, as defined by
the Unicode Standard.
|
|
static boolean |
isISOControl(char ch)
Determines if the specified character is an ISO control
character.
|
|
static boolean |
isISOControl(int codePoint)
Determines if the referenced character (Unicode code point) is an ISO control
character.
|
|
static boolean |
isJavaIdentifierPart(char ch)
Determines if the specified character may be part of a Java
identifier as other than the first character.
|
|
static boolean |
isJavaIdentifierPart(int codePoint)
Determines if the character (Unicode code point) may be part of a Java
identifier as other than the first character.
|
|
static boolean |
isJavaIdentifierStart(char ch)
Determines if the specified character is
permissible as the first character in a Java identifier.
|
|
static boolean |
isJavaIdentifierStart(int codePoint)
Determines if the character (Unicode code point) is
permissible as the first character in a Java identifier.
|
|
static boolean |
isJavaLetter(char ch)
Deprecated. Replaced by isJavaIdentifierStart(char).
|
|
static boolean |
isJavaLetterOrDigit(char ch)
Deprecated. Replaced by isJavaIdentifierPart(char).
|
|
static boolean |
isLetter(char ch)
Determines if the specified character is a letter.
|
|
static boolean |
isLetter(int codePoint)
Determines if the specified character (Unicode code point) is a letter.
|
|
static boolean |
isLetterOrDigit(char ch)
Determines if the specified character is a letter or digit.
|
|
static boolean |
isLetterOrDigit(int codePoint)
Determines if the specified character (Unicode code point) is a letter or digit.
|
|
static boolean |
isLowerCase(char ch)
Determines if the specified character is a lowercase character.
|
|
static boolean |
isLowerCase(int codePoint)
Determines if the specified character (Unicode code point) is a
lowercase character.
|
|
static boolean |
isLowSurrogate(char ch)
Determines if the given char value is a
Unicode low-surrogate code unit
(also known as trailing-surrogate code unit).
|
|
static boolean |
isMirrored(char ch)
Determines whether the character is mirrored according to the
Unicode specification.
|
|
static boolean |
isMirrored(int codePoint)
Determines whether the specified character (Unicode code point)
is mirrored according to the Unicode specification.
|
|
static boolean |
isSpace(char ch)
Deprecated. Replaced by isWhitespace(char).
|
|
static boolean |
isSpaceChar(char ch)
Determines if the specified character is a Unicode space character.
|
|
static boolean |
isSpaceChar(int codePoint)
Determines if the specified character (Unicode code point) is a
Unicode space character.
|
|
static boolean |
isSupplementaryCodePoint(int codePoint)
Determines whether the specified character (Unicode code point)
is in the supplementary character range.
|
|
static boolean |
isSurrogate(char ch)
Determines if the given char value is a Unicode
surrogate code unit.
|
|
static boolean |
isSurrogatePair(char high, char low)
Determines whether the specified pair of char
values is a valid
Unicode surrogate pair.
|
|
static boolean |
isTitleCase(char ch)
Determines if the specified character is a titlecase character.
|
|
static boolean |
isTitleCase(int codePoint)
Determines if the specified character (Unicode code point) is a titlecase character.
|
|
static boolean |
isUnicodeIdentifierPart(char ch)
Determines if the specified character may be part of a Unicode
identifier as other than the first character.
|
|
static boolean |
isUnicodeIdentifierPart(int codePoint)
Determines if the specified character (Unicode code point) may be part of a Unicode
identifier as other than the first character.
|
|
static boolean |
isUnicodeIdentifierStart(char ch)
Determines if the specified character is permissible as the
first character in a Unicode identifier.
|
|
static boolean |
isUnicodeIdentifierStart(int codePoint)
Determines if the specified character (Unicode code point) is permissible as the
first character in a Unicode identifier.
|
|
static boolean |
isUpperCase(char ch)
Determines if the specified character is an uppercase character.
|
|
static boolean |
isUpperCase(int codePoint)
Determines if the specified character (Unicode code point) is an uppercase character.
|
|
static boolean |
isValidCodePoint(int codePoint)
Determines whether the specified code point is a valid
Unicode code point value.
|
|
static boolean |
isWhitespace(char ch)
Determines if the specified character is white space according to Java.
|
|
static boolean |
isWhitespace(int codePoint)
Determines if the specified character (Unicode code point) is
white space according to Java.
|
|
static char |
lowSurrogate(int codePoint)
Returns the trailing surrogate (a
low surrogate code unit) of the
surrogate pair
representing the specified supplementary character (Unicode
code point) in the UTF-16 encoding.
|
|
static int |
offsetByCodePoints(char[] a, int start, int count, int index, int codePointOffset)
Returns the index within the given char subarray
that is offset from the given index by
codePointOffset code points.
|
|
static int |
offsetByCodePoints(CharSequence seq, int index, int codePointOffset)
Returns the index within the given char sequence that is offset
from the given index by codePointOffset
code points.
|
|
static char |
reverseBytes(char ch)
Returns the value obtained by reversing the order of the bytes in the
specified char value.
|
|
static char[] |
toChars(int codePoint)
Converts the specified character (Unicode code point) to its
UTF-16 representation stored in a char array.
|
|
static int |
toChars(int codePoint, char[] dst, int dstIndex)
Converts the specified character (Unicode code point) to its
UTF-16 representation.
|
|
static int |
toCodePoint(char high, char low)
Converts the specified surrogate pair to its supplementary code
point value.
|
|
static char |
toLowerCase(char ch)
Converts the character argument to lowercase using case
mapping information from the UnicodeData file.
|
|
static int |
toLowerCase(int codePoint)
Converts the character (Unicode code point) argument to
lowercase using case mapping information from the UnicodeData
file.
|
|
toString()
Returns a String object representing this
Character's value.
|
||
static String |
toString(char c)
Returns a String object representing the
specified char.
|
|
static String |
toString(int codePoint)
Returns a String object representing the
specified character (Unicode code point).
|
|
static char |
toTitleCase(char ch)
Converts the character argument to titlecase using case mapping
information from the UnicodeData file.
|
|
static int |
toTitleCase(int codePoint)
Converts the character (Unicode code point) argument to titlecase using case mapping
information from the UnicodeData file.
|
|
static char |
toUpperCase(char ch)
Converts the character argument to uppercase using case mapping
information from the UnicodeData file.
|
|
static int |
toUpperCase(int codePoint)
Converts the character (Unicode code point) argument to
uppercase using case mapping information from the UnicodeData
file.
|
|
static Character |
valueOf(char c)
Returns a Character instance representing the specified
char value.
|
Methods inherited from class java.lang.Object |
public Character |
(char value) |
() |
public static Character valueOf |
(char c) |
public char charValue |
() |
public int hashCode |
() |
public static int hashCode |
(char value) |
public boolean equals |
(Object obj) |
public String toString |
() |
public static String toString |
(char c) |
public static String toString |
(int codePoint) |
public static boolean isValidCodePoint |
(int codePoint) |
public static boolean isBmpCodePoint |
(int codePoint) |
public static boolean isSupplementaryCodePoint |
(int codePoint) |
public static boolean isHighSurrogate |
(char ch) |
Such values do not represent characters by themselves, but are used in the representation of supplementary characters in the UTF-16 encoding.
public static boolean isLowSurrogate |
(char ch) |
Such values do not represent characters by themselves, but are used in the representation of supplementary characters in the UTF-16 encoding.
public static boolean isSurrogate |
(char ch) |
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 low-surrogate code unit or a high-surrogate code unit.
public static boolean isSurrogatePair |
(char high, char low) |
This method is equivalent to the expression:
isHighSurrogate(high) && isLowSurrogate(low)
public static int charCount |
(int codePoint) |
This method doesn't validate the specified character to be a valid Unicode code point. The caller must validate the character value using isValidCodePoint if necessary.
public static int toCodePoint |
(char high, char low) |
public static int codePointAt |
(CharSequence seq, int index) |
public static int codePointAt |
(char[] a, int index) |
public static int codePointAt |
(char[] a, int index, int limit) |
public static int codePointBefore |
(CharSequence seq, int index) |
public static int codePointBefore |
(char[] a, int index) |
public static int codePointBefore |
(char[] a, int index, int start) |
public static char highSurrogate |
(int codePoint) |
If isSupplementaryCodePoint(x) is true, then isHighSurrogate(highSurrogate(x)) and toCodePoint(highSurrogate(x), lowSurrogate(x)) == x are also always true.
public static char lowSurrogate |
(int codePoint) |
If isSupplementaryCodePoint(x) is true, then isLowSurrogate(lowSurrogate(x)) and toCodePoint(highSurrogate(x), lowSurrogate(x)) == x are also always true.
public static int toChars |
(int codePoint, char[] dst, int dstIndex) |
public static char[] toChars |
(int codePoint) |
public static int codePointCount |
public static int codePointCount |
(char[] a, int offset, int count) |
public static int offsetByCodePoints |
public static int offsetByCodePoints |
(char[] a, int start, int count, int index, int codePointOffset) |
public static boolean isLowerCase |
(char ch) |
A character is lowercase if its general category type, provided by Character.getType(ch), is LOWERCASE_LETTER, or it has contributory property Other_Lowercase as defined by the Unicode Standard.
The following are examples of lowercase characters:
a b c d e f g h i j k l m n o p q r s t u v w x y z '\u00DF' '\u00E0' '\u00E1' '\u00E2' '\u00E3' '\u00E4' '\u00E5' '\u00E6' '\u00E7' '\u00E8' '\u00E9' '\u00EA' '\u00EB' '\u00EC' '\u00ED' '\u00EE' '\u00EF' '\u00F0' '\u00F1' '\u00F2' '\u00F3' '\u00F4' '\u00F5' '\u00F6' '\u00F8' '\u00F9' '\u00FA' '\u00FB' '\u00FC' '\u00FD' '\u00FE' '\u00FF'
Many other Unicode characters are lowercase too.
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the isLowerCase(int) method.
public static boolean isLowerCase |
(int codePoint) |
A character is lowercase if its general category type, provided by getType(codePoint), is LOWERCASE_LETTER, or it has contributory property Other_Lowercase as defined by the Unicode Standard.
The following are examples of lowercase characters:
a b c d e f g h i j k l m n o p q r s t u v w x y z '\u00DF' '\u00E0' '\u00E1' '\u00E2' '\u00E3' '\u00E4' '\u00E5' '\u00E6' '\u00E7' '\u00E8' '\u00E9' '\u00EA' '\u00EB' '\u00EC' '\u00ED' '\u00EE' '\u00EF' '\u00F0' '\u00F1' '\u00F2' '\u00F3' '\u00F4' '\u00F5' '\u00F6' '\u00F8' '\u00F9' '\u00FA' '\u00FB' '\u00FC' '\u00FD' '\u00FE' '\u00FF'
Many other Unicode characters are lowercase too.
public static boolean isUpperCase |
(char ch) |
A character is uppercase if its general category type, provided by Character.getType(ch), is UPPERCASE_LETTER. or it has contributory property Other_Uppercase as defined by the Unicode Standard.
The following are examples of uppercase characters:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z '\u00C0' '\u00C1' '\u00C2' '\u00C3' '\u00C4' '\u00C5' '\u00C6' '\u00C7' '\u00C8' '\u00C9' '\u00CA' '\u00CB' '\u00CC' '\u00CD' '\u00CE' '\u00CF' '\u00D0' '\u00D1' '\u00D2' '\u00D3' '\u00D4' '\u00D5' '\u00D6' '\u00D8' '\u00D9' '\u00DA' '\u00DB' '\u00DC' '\u00DD' '\u00DE'
Many other Unicode characters are uppercase too.
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the isUpperCase(int) method.
public static boolean isUpperCase |
(int codePoint) |
A character is uppercase if its general category type, provided by getType(codePoint), is UPPERCASE_LETTER, or it has contributory property Other_Uppercase as defined by the Unicode Standard.
The following are examples of uppercase characters:
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z '\u00C0' '\u00C1' '\u00C2' '\u00C3' '\u00C4' '\u00C5' '\u00C6' '\u00C7' '\u00C8' '\u00C9' '\u00CA' '\u00CB' '\u00CC' '\u00CD' '\u00CE' '\u00CF' '\u00D0' '\u00D1' '\u00D2' '\u00D3' '\u00D4' '\u00D5' '\u00D6' '\u00D8' '\u00D9' '\u00DA' '\u00DB' '\u00DC' '\u00DD' '\u00DE'
Many other Unicode characters are uppercase too.
public static boolean isTitleCase |
(char ch) |
A character is a titlecase character if its general category type, provided by Character.getType(ch), is TITLECASE_LETTER.
Some characters look like pairs of Latin letters. For example, there is an uppercase letter that looks like "LJ" and has a corresponding lowercase letter that looks like "lj". A third form, which looks like "Lj", is the appropriate form to use when rendering a word in lowercase with initial capitals, as for a book title.
These are some of the Unicode characters for which this method returns true:
Many other Unicode characters are titlecase too.
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the isTitleCase(int) method.
public static boolean isTitleCase |
(int codePoint) |
A character is a titlecase character if its general category type, provided by getType(codePoint), is TITLECASE_LETTER.
Some characters look like pairs of Latin letters. For example, there is an uppercase letter that looks like "LJ" and has a corresponding lowercase letter that looks like "lj". A third form, which looks like "Lj", is the appropriate form to use when rendering a word in lowercase with initial capitals, as for a book title.
These are some of the Unicode characters for which this method returns true:
Many other Unicode characters are titlecase too.
public static boolean isDigit |
(char ch) |
A character is a digit if its general category type, provided by Character.getType(ch), is DECIMAL_DIGIT_NUMBER.
Some Unicode character ranges that contain digits:
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the isDigit(int) method.
public static boolean isDigit |
(int codePoint) |
A character is a digit if its general category type, provided by getType(codePoint), is DECIMAL_DIGIT_NUMBER.
Some Unicode character ranges that contain digits:
public static boolean isDefined |
(char ch) |
A character is defined if at least one of the following is true:
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the isDefined(int) method.
public static boolean isDefined |
(int codePoint) |
A character is defined if at least one of the following is true:
public static boolean isLetter |
(char ch) |
A character is considered to be a letter if its general category type, provided by Character.getType(ch), is any of the following:
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the isLetter(int) method.
public static boolean isLetter |
(int codePoint) |
A character is considered to be a letter if its general category type, provided by getType(codePoint), is any of the following:
public static boolean isLetterOrDigit |
(char ch) |
A character is considered to be a letter or digit if either Character.isLetter(char ch) or Character.isDigit(char ch) returns true for the character.
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the isLetterOrDigit(int) method.
public static boolean isLetterOrDigit |
(int codePoint) |
A character is considered to be a letter or digit if either isLetter(codePoint) or isDigit(codePoint) returns true for the character.
public static boolean isJavaLetter |
(char ch) |
A character may start a Java identifier if and only if one of the following conditions is true:
public static boolean isJavaLetterOrDigit |
(char ch) |
A character may be part of a Java identifier if and only if one of the following conditions is true:
public static boolean isAlphabetic |
(int codePoint) |
A character is considered to be alphabetic if its general category type, provided by getType(codePoint), is any of the following:
public static boolean isIdeographic |
(int codePoint) |
public static boolean isJavaIdentifierStart |
(char ch) |
A character may start a Java identifier if and only if one of the following conditions is true:
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the isJavaIdentifierStart(int) method.
public static boolean isJavaIdentifierStart |
(int codePoint) |
A character may start a Java identifier if and only if one of the following conditions is true:
public static boolean isJavaIdentifierPart |
(char ch) |
A character may be part of a Java identifier if any of the following conditions are true:
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the isJavaIdentifierPart(int) method.
public static boolean isJavaIdentifierPart |
(int codePoint) |
A character may be part of a Java identifier if any of the following conditions are true:
public static boolean isUnicodeIdentifierStart |
(char ch) |
A character may start a Unicode identifier if and only if one of the following conditions is true:
This method conforms to UAX31-R1: Default Identifiers requirement of the Unicode Standard, with the following profile of UAX31:
Start := ID_Start + 'VERTICAL TILDE' (U+2E2F)'VERTICAL TILDE' is added to Start for backward compatibility.
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the isUnicodeIdentifierStart(int) method.
public static boolean isUnicodeIdentifierStart |
(int codePoint) |
A character may start a Unicode identifier if and only if one of the following conditions is true:
This method conforms to UAX31-R1: Default Identifiers requirement of the Unicode Standard, with the following profile of UAX31:
Start := ID_Start + 'VERTICAL TILDE' (U+2E2F)'VERTICAL TILDE' is added to Start for backward compatibility.
public static boolean isUnicodeIdentifierPart |
(char ch) |
A character may be part of a Unicode identifier if and only if one of the following statements is true:
This method conforms to UAX31-R1: Default Identifiers requirement of the Unicode Standard, with the following profile of UAX31:
Continue := Start + ID_Continue + ignorable Medial := empty ignorable := isIdentifierIgnorable(char) returns true for the characterignorable is added to Continue for backward compatibility.
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the isUnicodeIdentifierPart(int) method.
public static boolean isUnicodeIdentifierPart |
(int codePoint) |
A character may be part of a Unicode identifier if and only if one of the following statements is true:
This method conforms to UAX31-R1: Default Identifiers requirement of the Unicode Standard, with the following profile of UAX31:
Continue := Start + ID_Continue + ignorable Medial := empty ignorable := isIdentifierIgnorable(int) returns true for the characterignorable is added to Continue for backward compatibility.
public static boolean isIdentifierIgnorable |
(char ch) |
The following Unicode characters are ignorable in a Java identifier or a Unicode identifier:
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the isIdentifierIgnorable(int) method.
public static boolean isIdentifierIgnorable |
(int codePoint) |
The following Unicode characters are ignorable in a Java identifier or a Unicode identifier:
public static char toLowerCase |
(char ch) |
Note that Character.isLowerCase(Character.toLowerCase(ch)) does not always return true for some ranges of characters, particularly those that are symbols or ideographs.
In general, String.toLowerCase() should be used to map characters to lowercase. String case mapping methods have several benefits over Character case mapping methods. String case mapping methods can perform locale-sensitive mappings, context-sensitive mappings, and 1:M character mappings, whereas the Character case mapping methods cannot.
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the toLowerCase(int) method.
public static int toLowerCase |
(int codePoint) |
Note that Character.isLowerCase(Character.toLowerCase(codePoint)) does not always return true for some ranges of characters, particularly those that are symbols or ideographs.
In general, String.toLowerCase() should be used to map characters to lowercase. String case mapping methods have several benefits over Character case mapping methods. String case mapping methods can perform locale-sensitive mappings, context-sensitive mappings, and 1:M character mappings, whereas the Character case mapping methods cannot.
public static char toUpperCase |
(char ch) |
Note that Character.isUpperCase(Character.toUpperCase(ch)) does not always return true for some ranges of characters, particularly those that are symbols or ideographs.
In general, String.toUpperCase() should be used to map characters to uppercase. String case mapping methods have several benefits over Character case mapping methods. String case mapping methods can perform locale-sensitive mappings, context-sensitive mappings, and 1:M character mappings, whereas the Character case mapping methods cannot.
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the toUpperCase(int) method.
public static int toUpperCase |
(int codePoint) |
Note that Character.isUpperCase(Character.toUpperCase(codePoint)) does not always return true for some ranges of characters, particularly those that are symbols or ideographs.
In general, String.toUpperCase() should be used to map characters to uppercase. String case mapping methods have several benefits over Character case mapping methods. String case mapping methods can perform locale-sensitive mappings, context-sensitive mappings, and 1:M character mappings, whereas the Character case mapping methods cannot.
public static char toTitleCase |
(char ch) |
Note that Character.isTitleCase(Character.toTitleCase(ch)) does not always return true for some ranges of characters.
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the toTitleCase(int) method.
public static int toTitleCase |
(int codePoint) |
Note that Character.isTitleCase(Character.toTitleCase(codePoint)) does not always return true for some ranges of characters.
public static int digit |
(char ch, int radix) |
If the radix is not in the range MIN_RADIX ≤ radix ≤ MAX_RADIX or if the value of ch is not a valid digit in the specified radix, -1 is returned. A character is a valid digit if at least one of the following is true:
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the digit(int, int) method.
public static int digit |
(int codePoint, int radix) |
If the radix is not in the range MIN_RADIX ≤ radix ≤ MAX_RADIX or if the character is not a valid digit in the specified radix, -1 is returned. A character is a valid digit if at least one of the following is true:
public static int getNumericValue |
(char ch) |
The letters A-Z in their uppercase ('\u0041' through '\u005A'), lowercase ('\u0061' through '\u007A'), and full width variant ('\uFF21' through '\uFF3A' and '\uFF41' through '\uFF5A') forms have numeric values from 10 through 35. This is independent of the Unicode specification, which does not assign numeric values to these char values.
If the character does not have a numeric value, then -1 is returned. If the character has a numeric value that cannot be represented as a nonnegative integer (for example, a fractional value), then -2 is returned.
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the getNumericValue(int) method.
public static int getNumericValue |
(int codePoint) |
The letters A-Z in their uppercase ('\u0041' through '\u005A'), lowercase ('\u0061' through '\u007A'), and full width variant ('\uFF21' through '\uFF3A' and '\uFF41' through '\uFF5A') forms have numeric values from 10 through 35. This is independent of the Unicode specification, which does not assign numeric values to these char values.
If the character does not have a numeric value, then -1 is returned. If the character has a numeric value that cannot be represented as a nonnegative integer (for example, a fractional value), then -2 is returned.
public static boolean isSpace |
(char ch) |
Character | Code | Name |
---|---|---|
'\t' | U+0009 | HORIZONTAL TABULATION |
'\n' | U+000A | NEW LINE |
'\f' | U+000C | FORM FEED |
'\r' | U+000D | CARRIAGE RETURN |
' ' | U+0020 | SPACE |
public static boolean isSpaceChar |
(char ch) |
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the isSpaceChar(int) method.
public static boolean isSpaceChar |
(int codePoint) |
public static boolean isWhitespace |
(char ch) |
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the isWhitespace(int) method.
public static boolean isWhitespace |
(int codePoint) |
public static boolean isISOControl |
(char ch) |
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the isISOControl(int) method.
public static boolean isISOControl |
(int codePoint) |
public static int getType |
(char ch) |
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the getType(int) method.
public static int getType |
(int codePoint) |
public static char forDigit |
(int digit, int radix) |
The radix argument is valid if it is greater than or equal to MIN_RADIX and less than or equal to MAX_RADIX. The digit argument is valid if 0 <= digit < radix.
If the digit is less than 10, then '0' + digit is returned. Otherwise, the value 'a' + digit - 10 is returned.
public static byte getDirectionality |
(char ch) |
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the getDirectionality(int) method.
public static byte getDirectionality |
(int codePoint) |
public static boolean isMirrored |
(char ch) |
Note: This method cannot handle supplementary characters. To support all Unicode characters, including supplementary characters, use the isMirrored(int) method.
public static boolean isMirrored |
(int codePoint) |
public int compareTo |
(Character anotherCharacter) |
public static int compare |
(char x, char y) |
Character.valueOf(x).compareTo(Character.valueOf(y))
public static char reverseBytes |
(char ch) |
public static String getName |
(int codePoint) |
Note: if the specified character is not assigned a name by the UnicodeData file (part of the Unicode Character Database maintained by the Unicode Consortium), the returned name is the same as the result of expression:
Character.UnicodeBlock.of(codePoint).toString().replace('_', ' ') + " " + Integer.toHexString(codePoint).toUpperCase(Locale.ROOT);
public static int codePointOf |
(String name) |
Note: if a character is not assigned a name by the UnicodeData file (part of the Unicode Character Database maintained by the Unicode Consortium), its name is defined as the result of expression:
Character.UnicodeBlock.of(codePoint).toString().replace('_', ' ') + " " + Integer.toHexString(codePoint).toUpperCase(Locale.ROOT);
The name matching is case insensitive, with any leading and trailing whitespace character removed.
|
FlexDoc/Javadoc 2.0 Demo Java Doc |