Java Doc for Character.java in  » Apache-Harmony-Java-SE » java-package » java » lang » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Character is the wrapper for the primitive type char. This class also provides a number of utility methods for working with chars.

Character data is based upon the Unicode Standard, 4.0. The Unicode specification, character tables and other information are available at http://www.unicode.org/.

Unicode characters are referred to as code points. The range of valid code points is U+0000 to U+10FFFF. The Basic Multilingual Plane (BMP) is the code point range U+0000 to U+FFFF. Characters above the BMP are referred to as Supplementary Characters. On the Java platform, UTF-16 encoding and char pairs are used to represent code points in the supplementary range. A pair of char values that represent a supplementary character are made up of a high surrogate with a value range of 0xD800 to 0xDBFF and a low surrogate with a value range of 0xDC00 to 0xDFFF.

On the Java platform a char value represents either a single BMP code point or a UTF-16 unit that's part of a surrogate pair. The int type is used to represent all Unicode code points.

Maximum code point value - U+10FFFF.

Maximum value of a high surrogate or leading surrogate unit in UTF-16 encoding - '\uDBFF'.

Maximum value of a surrogate unit in UTF-16 encoding - '\uDFFF'.

Minimum code point value - U+0000.

Minimum value of a high surrogate or leading surrogate unit in UTF-16 encoding - '\uD800'.

Minimum value of a low surrogate or trailing surrogate unit in UTF-16 encoding - '\uDC00'.

Minimum value of a supplementary code point - U+010000.

Minimum value of a surrogate unit in UTF-16 encoding - '\uD800'.

Constant for the number of bits to represent a char in two's compliment form.

Calculates the number of char values required to represent the Unicode code point.

Returns the code point at the index in the CharSequence. If char unit at the index is a high-surrogate unit, the next index is less than the length of the sequence and the char unit at the next index is a low surrogate unit, then the code point represented by the pair is returned; otherwise the char unit at the index is returned.

Returns the code point at the index in the char[].

Returns the code point at the index in the char[] that's within the limit.

Returns the Unicode code point that proceeds the index in the CharSequence.

Returns the Unicode code point that proceeds the index in the char[].

Returns the Unicode code point that proceeds the index in the char[] and isn't less than start.

Counts the number of Unicode code points in the subsequence of the CharSequence, as delineated by the beginIndex and endIndex.

Counts the number of Unicode code points in the subsequence of the char[], as delineated by the offset and count.

A test for determining if the char is a high surrogate/leading surrogate unit that's used for representing supplementary characters in UTF-16 encoding.

A test for determining if the char is a high surrogate/leading surrogate unit that's used for representing supplementary characters in UTF-16 encoding.

A test for determining if the codePoint is within the supplementary code point range.

A test for determining if the char pair is a valid surrogate pair.

A test for determining if the codePoint is a valid Unicode code point.

Determines the index into the CharSequence that is offset (measured in code points and specified by codePointOffset), from the index argument.

Determines the index into the char[] that is offset (measured in code points and specified by codePointOffset), from the index argument and is within the subsequence as delineated by start and count.

Converts the Unicode code point, codePoint, into a UTF-16 encoded sequence and copies the value(s) into the char[] dst, starting at the index dstIndex.

Converts the Unicode code point, codePoint, into a UTF-16 encoded sequence that is returned as a char[].

Converts a surrogate pair into a Unicode code point.

Returns a Character instance for the char value passed.

Maximum code point value - U+10FFFF.

Maximum value of a high surrogate or leading surrogate unit in UTF-16 encoding - '\uDBFF'.

Maximum value of a surrogate unit in UTF-16 encoding - '\uDFFF'.

Minimum code point value - U+0000.

Minimum value of a high surrogate or leading surrogate unit in UTF-16 encoding - '\uD800'.

Minimum value of a low surrogate or trailing surrogate unit in UTF-16 encoding - '\uDC00'.

Minimum value of a supplementary code point - U+010000.

Minimum value of a surrogate unit in UTF-16 encoding - '\uD800'.

Constant for the number of bits to represent a char in two's compliment form.

Calculates the number of char values required to represent the Unicode code point. This method only tests if the codePoint is greater than or equal to 0x10000, in which case 2 is returned, otherwise 1. To test if the code point is valid, use the Character.isValidCodePoint(int) method.

Returns the code point at the index in the CharSequence. If char unit at the index is a high-surrogate unit, the next index is less than the length of the sequence and the char unit at the next index is a low surrogate unit, then the code point represented by the pair is returned; otherwise the char unit at the index is returned.

Returns the code point at the index in the char[]. If char unit at the index is a high-surrogate unit, the next index is less than the length of the sequence and the char unit at the next index is a low surrogate unit, then the code point represented by the pair is returned; otherwise the char unit at the index is returned.

Returns the code point at the index in the char[] that's within the limit. If char unit at the index is a high-surrogate unit, the next index is less than the limit and the char unit at the next index is a low surrogate unit, then the code point represented by the pair is returned; otherwise the char unit at the index is returned.

Returns the Unicode code point that proceeds the index in the CharSequence. If the char unit at index - 1 is within the low surrogate range, the value index - 2 isn't negative and the char unit at index - 2 is within the high surrogate range, then the supplementary code point made up of the surrogate pair is returned; otherwise, the char value at index - 1 is returned.

Returns the Unicode code point that proceeds the index in the char[]. If the char unit at index - 1 is within the low surrogate range, the value index - 2 isn't negative and the char unit at index - 2 is within the high surrogate range, then the supplementary code point made up of the surrogate pair is returned; otherwise, the char value at index - 1 is returned.

Returns the Unicode code point that proceeds the index in the char[] and isn't less than start. If the char unit at index - 1 is within the low surrogate range, the value index - 2 isn't less than start and the char unit at index - 2 is within the high surrogate range, then the supplementary code point made up of the surrogate pair is returned; otherwise, the char value at index - 1 is returned.

Counts the number of Unicode code points in the subsequence of the CharSequence, as delineated by the beginIndex and endIndex. Any surrogate values with missing pair values will be counted as 1 code point.

Counts the number of Unicode code points in the subsequence of the char[], as delineated by the offset and count. Any surrogate values with missing pair values will be counted as 1 code point.

In this case, the argument must also be a Character, and the receiver and argument must represent the same char value.
Parameters:
  object - the object to compare with this object true if the object is the same as this objectfalse if it is different from this object
See Also:   Character.hashCode

A test for determining if the char is a high surrogate/leading surrogate unit that's used for representing supplementary characters in UTF-16 encoding.

A test for determining if the char is a high surrogate/leading surrogate unit that's used for representing supplementary characters in UTF-16 encoding.

A test for determining if the codePoint is within the supplementary code point range.

A test for determining if the char pair is a valid surrogate pair.

A test for determining if the codePoint is a valid Unicode code point.

Determines the index into the CharSequence that is offset (measured in code points and specified by codePointOffset), from the index argument.

Determines the index into the char[] that is offset (measured in code points and specified by codePointOffset), from the index argument and is within the subsequence as delineated by start and count.

Converts the Unicode code point, codePoint, into a UTF-16 encoded sequence and copies the value(s) into the char[] dst, starting at the index dstIndex.

Converts the Unicode code point, codePoint, into a UTF-16 encoded sequence that is returned as a char[].

Converts a surrogate pair into a Unicode code point. This method assume that the pair are valid surrogates. If the pair are NOT valid surrogates, then the result is indeterminate. The Character.isSurrogatePair(char,char) method should be used prior to this method to validate the pair.

Returns a Character instance for the char value passed. This method is preferred over the constructor, as this method may maintain a cache of instances.