|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一個類別 下一個類別 | 框架 無框架 | |||||||||
摘要: 巢狀 | 欄位 | 建構子 | 方法 | 詳細資訊: 欄位 | 建構子 | 方法 |
java.lang.Object java.lang.Character
public final class Character
Character
類別在物件中包裹一個基本型別 char
的值。Character
型別的物件包含型別為 char
的單個欄位。
此外,該類別提供了幾種方法,以確定字元的類別別(小寫字母,數字,等等),並將字元從大寫轉換成小寫,反之亦然。
字元資訊基於 Unicode 標準,版本 4.0。
Character
類別的方法和資料是通過 UnicodeData 檔案中的資訊定義的,該檔案是 Unicode Consortium 維護的 Unicode Character Database 的一部分。此檔案指定了各種屬性,其中包括每個已定義 Unicode 程式碼點或字元範圍的名稱和常規類別別。
此檔案及其描述可從 Unicode Consortium 獲得,網址如下:
char
資料型別(和 Character
物件封裝的值)基於原始的 Unicode 規範,將字元定義為固定寬度的 16 位實體。Unicode 標準曾做過修改,以允許那些其表示形式需要超過 16 位的字元。合法程式碼點 的範圍現在是從 U+0000 到 U+10FFFF,即通常所說的 Unicode 標量值。(請參閱 Unicode 標準中 U+n 表示法的定義。)
從 U+0000 到 U+FFFF 的字元集有時也稱為 Basic Multilingual Plane (BMP)。程式碼點大於 U+FFFF 的字元稱為增補字元。Java 2 平臺在 char
陣列以及 String
和 StringBuffer
類別中使用 UTF-16 表示形式。在這種表現形式中,增補字元表示為一對 char
值,第一個值取自高代理項 範圍,即 (\uD800-\uDBFF),第二個值取自低代理項 範圍,即 (\uDC00-\uDFFF)。
所以,char
值表示 Basic Multilingual Plane (BMP) 程式碼點,其中包括代理項程式碼點,或 UTF-16 編碼的程式碼單元。int
值表示所有 Unicode 程式碼點,包括增補程式碼點。int
的 21 個低位(最低有效位)用於表示 Unicode 程式碼點,並且 11 個高位(最高有效位)必須為零。除非另有指定,否則與增補字元和代理項 char
值有關的行為如下:
char
值的方法無法支持增補字元。它們將代理項字元範圍內的 char
值視為未定義字元。例如,Character.isLetter('\uD840')
返回 false
,即使是特定值,如果在字元串的後面跟著任何低代理項值,那麼它將表示一個字母。
int
值的方法支持所有 Unicode 字元,其中包括增補字元。例如,Character.isLetter(0x2F81A)
返回 true
,因為程式碼點值表示一個字母(一個 CJK 象形文字)。
在 Java SE API 文檔中,Unicode 程式碼點 用於範圍在 U+0000 與 U+10FFFF 之間的字元值,而 Unicode 程式碼點 用於作為 UTF-16 編碼的程式碼單元的 16 位 char
值。有關 Unicode 技術的詳細資訊,請參閱 Unicode Glossary。
巢狀類別摘要 | |
---|---|
static class |
Character.Subset
此類別的實例表示 Unicode 字元集的特定子集。 |
static class |
Character.UnicodeBlock
表示 Unicode 規範中字元塊的一系列字元子集。 |
欄位摘要 | |
---|---|
static byte |
COMBINING_SPACING_MARK
Unicode 規範中的常規類別別“Mc”。 |
static byte |
CONNECTOR_PUNCTUATION
Unicode 規範中的常規類別別“Pc”。 |
static byte |
CONTROL
Unicode 規範中的常規類別別“Cc”。 |
static byte |
CURRENCY_SYMBOL
Unicode 規範中的常規類別別“Sc”。 |
static byte |
DASH_PUNCTUATION
Unicode 規範中的常規類別別“Pd”。 |
static byte |
DECIMAL_DIGIT_NUMBER
Unicode 規範中的常規類別別“Nd”。 |
static byte |
DIRECTIONALITY_ARABIC_NUMBER
Unicode 規範中的弱雙向字元型別“AN”。 |
static byte |
DIRECTIONALITY_BOUNDARY_NEUTRAL
Unicode 規範中的弱雙向字元型別“BN”。 |
static byte |
DIRECTIONALITY_COMMON_NUMBER_SEPARATOR
Unicode 規範中的弱雙向字元型別“CS”。 |
static byte |
DIRECTIONALITY_EUROPEAN_NUMBER
Unicode 規範中的弱雙向字元型別“EN”。 |
static byte |
DIRECTIONALITY_EUROPEAN_NUMBER_SEPARATOR
Unicode 規範中的弱雙向字元型別“ES”。 |
static byte |
DIRECTIONALITY_EUROPEAN_NUMBER_TERMINATOR
Unicode 規範中的弱雙向字元型別“ET”。 |
static byte |
DIRECTIONALITY_LEFT_TO_RIGHT
Unicode 規範中的強雙向字元型別“L”。 |
static byte |
DIRECTIONALITY_LEFT_TO_RIGHT_EMBEDDING
Unicode 規範中的強雙向字元型別“LRE”。 |
static byte |
DIRECTIONALITY_LEFT_TO_RIGHT_OVERRIDE
Unicode 規範中的強雙向字元型別“LRO”。 |
static byte |
DIRECTIONALITY_NONSPACING_MARK
Unicode 規範中的弱雙向字元型別“NSM”。 |
static byte |
DIRECTIONALITY_OTHER_NEUTRALS
Unicode 規範中的非特定雙向字元型別“ON”。 |
static byte |
DIRECTIONALITY_PARAGRAPH_SEPARATOR
Unicode 規範中的非特定雙向字元型別“B”。 |
static byte |
DIRECTIONALITY_POP_DIRECTIONAL_FORMAT
Unicode 規範中的弱雙向字元型別“PDF”。 |
static byte |
DIRECTIONALITY_RIGHT_TO_LEFT
Unicode 規範中的強雙向字元型別“R”。 |
static byte |
DIRECTIONALITY_RIGHT_TO_LEFT_ARABIC
Unicode 規範中的強雙向字元型別“AL”。 |
static byte |
DIRECTIONALITY_RIGHT_TO_LEFT_EMBEDDING
Unicode 規範中的強雙向字元型別“RLE”。 |
static byte |
DIRECTIONALITY_RIGHT_TO_LEFT_OVERRIDE
Unicode 規範中的強雙向字元型別“RLO”。 |
static byte |
DIRECTIONALITY_SEGMENT_SEPARATOR
Unicode 規範中的非特定雙向字元型別“S”。 |
static byte |
DIRECTIONALITY_UNDEFINED
未定義的雙向字元型別。 |
static byte |
DIRECTIONALITY_WHITESPACE
Unicode 規範中的非特定雙向字元型別“WS”。 |
static byte |
ENCLOSING_MARK
Unicode 規範中的常規類別別“Me”。 |
static byte |
END_PUNCTUATION
Unicode 規範中的常規類別別“Pe”。 |
static byte |
FINAL_QUOTE_PUNCTUATION
Unicode 規範中的常規類別別“Pf”。 |
static byte |
FORMAT
Unicode 規範中的常規類別別“Cf”。 |
static byte |
INITIAL_QUOTE_PUNCTUATION
Unicode 規範中的常規類別別“Pi”。 |
static byte |
LETTER_NUMBER
Unicode 規範中的常規類別別“Nl”。 |
static byte |
LINE_SEPARATOR
Unicode 規範中的常規類別別“Zl”。 |
static byte |
LOWERCASE_LETTER
Unicode 規範中的常規類別別“Ll”。 |
static byte |
MATH_SYMBOL
Unicode 規範中的常規類別別“Sm”。 |
static int |
MAX_CODE_POINT
Unicode 程式碼點的最大值。 |
static char |
MAX_HIGH_SURROGATE
UTF-16 編碼中的 Unicode 高代理項程式碼單元的最大值。 |
static char |
MAX_LOW_SURROGATE
UTF-16 編碼中的 Unicode 低代理項程式碼單元的最大值。 |
static int |
MAX_RADIX
可用於與字元串相互轉換的最大進制。 |
static char |
MAX_SURROGATE
UTF-16 編碼中的 Unicode 代理項程式碼單元的最大值。 |
static char |
MAX_VALUE
此欄位的常數值是 char 型別的最大值,即 '\uFFFF' 。 |
static int |
MIN_CODE_POINT
Unicode 程式碼點的最小值。 |
static char |
MIN_HIGH_SURROGATE
UTF-16 編碼中的 Unicode 高代理項程式碼單元的最小值。 |
static char |
MIN_LOW_SURROGATE
UTF-16 編碼中的 Unicode 低代理項程式碼單元的最小值。 |
static int |
MIN_RADIX
可用於與字元串相互轉換的最小進制。 |
static int |
MIN_SUPPLEMENTARY_CODE_POINT
增補程式碼點的最小值。 |
static char |
MIN_SURROGATE
UTF-16 編碼中的 Unicode 代理項程式碼單元的最小值。 |
static char |
MIN_VALUE
此欄位的常數值是 char 型別的最小值,即 '\u0000' 。 |
static byte |
MODIFIER_LETTER
Unicode 規範中的常規類別別“Lm”。 |
static byte |
MODIFIER_SYMBOL
Unicode 規範中的常規類別別“Sk”。 |
static byte |
NON_SPACING_MARK
Unicode 規範中的常規類別別“Mn”。 |
static byte |
OTHER_LETTER
Unicode 規範中的常規類別別“Lo”。 |
static byte |
OTHER_NUMBER
Unicode 規範中的常規類別別“No”。 |
static byte |
OTHER_PUNCTUATION
Unicode 規範中的常規類別別“Po”。 |
static byte |
OTHER_SYMBOL
Unicode 規範中的常規類別別“So”。 |
static byte |
PARAGRAPH_SEPARATOR
Unicode 規範中的常規類別別“Zp”。 |
static byte |
PRIVATE_USE
Unicode 規範中的常規類別別“Co”。 |
static int |
SIZE
用來以無符號二進制形式表示 char 值的位數。 |
static byte |
SPACE_SEPARATOR
Unicode 規範中的常規類別別“Zs”。 |
static byte |
START_PUNCTUATION
Unicode 規範中的常規類別別“Ps”。 |
static byte |
SURROGATE
Unicode 規範中的常規類別別“Cs”。 |
static byte |
TITLECASE_LETTER
Unicode 規範中的常規類別別“Lt”。 |
static Class<Character> |
TYPE
表示基本型別 char 的 Class 實例。 |
static byte |
UNASSIGNED
Unicode 規範中的常規類別別“Cn”。 |
static byte |
UPPERCASE_LETTER
Unicode 規範中的常規類別別“Lu”。 |
建構子摘要 | |
---|---|
Character(char value)
建構一個新分派的 Character 物件,用以表示指定的 char 值。 |
方法摘要 | |
---|---|
static int |
charCount(int codePoint)
確定表示指定字元(Unicode 程式碼點)所需的 char 值的數量。 |
char |
charValue()
返回此 Character 物件的值。 |
static int |
codePointAt(char[] a,
int index)
返回 char 陣列的給定索引上的程式碼點。 |
static int |
codePointAt(char[] a,
int index,
int limit)
返回 char 陣列的給定索引上的程式碼點,該陣列中只有那些具有小於 limit 的 index 值的陣列元素可以使用。 |
static int |
codePointAt(CharSequence seq,
int index)
返回 CharSequence 的給定索引上的程式碼點。 |
static int |
codePointBefore(char[] a,
int index)
返回 char 陣列的給定索引前面的程式碼點。 |
static int |
codePointBefore(char[] a,
int index,
int start)
返回 char 陣列的給定索引前面的程式碼點,該陣列中只有那些具有大於等於 start 的 index 值的陣列元素可以使用。 |
static int |
codePointBefore(CharSequence seq,
int index)
返回 CharSequence 的給定索引前面的程式碼點。 |
static int |
codePointCount(char[] a,
int offset,
int count)
返回 char 陣列參數的子陣列中 Unicode 程式碼點的數量。 |
static int |
codePointCount(CharSequence seq,
int beginIndex,
int endIndex)
返回指定字元序列的文本範圍內的 Unicode 程式碼點數量。 |
int |
compareTo(Character anotherCharacter)
根據數字比較兩個 Character 物件。 |
static int |
digit(char ch,
int radix)
返回使用指定進制的字元 ch 的數值。 |
static int |
digit(int codePoint,
int radix)
返回使用指定進制的指定字元(Unicode 程式碼點)的數值。 |
boolean |
equals(Object obj)
將此物件與指定物件比較。 |
static char |
forDigit(int digit,
int radix)
確定使用指定進制的特定數字的字元表示形式。 |
static byte |
getDirectionality(char ch)
返回給定字元的 Unicode 方向屬性。 |
static byte |
getDirectionality(int codePoint)
返回給定字元(Unicode 程式碼點)的 Unicode 方向屬性。 |
static int |
getNumericValue(char ch)
返回指定的 Unicode 字元表示的 int 值。 |
static int |
getNumericValue(int codePoint)
返回指定字元(Unicode 程式碼點)表示的 int 值。 |
static int |
getType(char ch)
返回一個指示字元的常規類別別的值。 |
static int |
getType(int codePoint)
返回一個指示字元的常規類別別的值。 |
int |
hashCode()
返回此 Character 的雜湊碼。 |
static boolean |
isDefined(char ch)
確定字元是否被定義為 Unicode 中的字元。 |
static boolean |
isDefined(int codePoint)
確定字元(Unicode 程式碼點)是否被定義為 Unicode 中的字元。 |
static boolean |
isDigit(char ch)
確定指定字元是否為數字。 |
static boolean |
isDigit(int codePoint)
確定指定字元(Unicode 程式碼點)是否為數字。 |
static boolean |
isHighSurrogate(char ch)
確定給出的 char 值是否為一個高代理項程式碼單元(也稱為前導代理項程式碼單元)。 |
static boolean |
isIdentifierIgnorable(char ch)
確定是否應該認為指定字元是 Java 標識符或 Unicode 標識符中可忽略的一個字元。 |
static boolean |
isIdentifierIgnorable(int codePoint)
確定是否應該認為指定字元(Unicode 程式碼點)是 Java 標識符或 Unicode 標識符中可忽略的一個字元。 |
static boolean |
isISOControl(char ch)
確定指定字元是否為 ISO 控制字元。 |
static boolean |
isISOControl(int codePoint)
確定參考的字元(Unicode 程式碼點)是否為 ISO 控制字元。 |
static boolean |
isJavaIdentifierPart(char ch)
確定指定字元是否可以是 Java 標識符中首字元以外的部分。 |
static boolean |
isJavaIdentifierPart(int codePoint)
確定字元(Unicode 程式碼點)是否可以是 Java 標識符中首字元以外的部分。 |
static boolean |
isJavaIdentifierStart(char ch)
確定是否允許將指定字元作為 Java 標識符中的首字元。 |
static boolean |
isJavaIdentifierStart(int codePoint)
確定是否允許將字元(Unicode 程式碼點)作為 Java 標識符中的首字元。 |
static boolean |
isJavaLetter(char ch)
已過時。 由 isJavaIdentifierStart(char) 取代。 |
static boolean |
isJavaLetterOrDigit(char ch)
已過時。 由 isJavaIdentifierPart(char) 取代。 |
static boolean |
isLetter(char ch)
確定指定字元是否為字母。 |
static boolean |
isLetter(int codePoint)
確定指定字元(Unicode 程式碼點)是否為字母。 |
static boolean |
isLetterOrDigit(char ch)
確定指定字元是否為字母或數字。 |
static boolean |
isLetterOrDigit(int codePoint)
確定指定字元(Unicode 程式碼點)是否為字母或數字。 |
static boolean |
isLowerCase(char ch)
確定指定字元是否為小寫字母。 |
static boolean |
isLowerCase(int codePoint)
確定指定字元(Unicode 程式碼點)是否為小寫字母。 |
static boolean |
isLowSurrogate(char ch)
確定給定 char 值是否一個低代理項程式碼單元(也稱為尾部代理項程式碼單元)。 |
static boolean |
isMirrored(char ch)
確定指定字元依據 Unicode 規範是否對稱。 |
static boolean |
isMirrored(int codePoint)
確定指定字元(Unicode 程式碼點)依據 Unicode 規範是否對稱。 |
static boolean |
isSpace(char ch)
已過時。 由 isWhitespace(char) 取代。 |
static boolean |
isSpaceChar(char ch)
確定指定字元是否為 Unicode 空白字元。 |
static boolean |
isSpaceChar(int codePoint)
確定指定字元(Unicode 程式碼點)是否為 Unicode 空白字元。 |
static boolean |
isSupplementaryCodePoint(int codePoint)
確定指定字元(Unicode 程式碼點)是否在增補字元範圍內。 |
static boolean |
isSurrogatePair(char high,
char low)
確定指定的 char 值對是否為有效的代理項對。 |
static boolean |
isTitleCase(char ch)
確定指定字元是否為首字母大寫字元。 |
static boolean |
isTitleCase(int codePoint)
確定指定字元(Unicode 程式碼點)是否為首字母大寫字元。 |
static boolean |
isUnicodeIdentifierPart(char ch)
確定指定字元是否可以是 Unicode 標識符中首字元以外的部分。 |
static boolean |
isUnicodeIdentifierPart(int codePoint)
確定指定字元(Unicode 程式碼點)是否可以是 Unicode 標識符中首字元以外的部分。 |
static boolean |
isUnicodeIdentifierStart(char ch)
確定是否允許將指定字元作為 Unicode 標識符中的首字元。 |
static boolean |
isUnicodeIdentifierStart(int codePoint)
確定是否允許將指定字元(Unicode 程式碼點)作為 Unicode 標識符中的首字元。 |
static boolean |
isUpperCase(char ch)
確定指定字元是否為大寫字母。 |
static boolean |
isUpperCase(int codePoint)
確定指定字元(Unicode 程式碼點)是否為大寫字母。 |
static boolean |
isValidCodePoint(int codePoint)
確定指定的程式碼點是否為從 0x0000 到 0x10FFFF 範圍之內的有效 Unicode 程式碼點值。 |
static boolean |
isWhitespace(char ch)
確定指定字元依據 Java 標準是否為空白字元。 |
static boolean |
isWhitespace(int codePoint)
確定指定字元(Unicode 程式碼點)依據 Java 標準是否為空白字元。 |
static int |
offsetByCodePoints(char[] a,
int start,
int count,
int index,
int codePointOffset)
返回給定 char 子陣列中的索引,它是從給定 index 到 codePointOffset 程式碼點的偏移量。 |
static int |
offsetByCodePoints(CharSequence seq,
int index,
int codePointOffset)
返回給定字元序列中的索引,它是從給定 index 到 codePointOffset 程式碼點的偏移量。 |
static char |
reverseBytes(char ch)
返回通過反轉指定 char 值中的位元組順序而獲得的值。 |
static char[] |
toChars(int codePoint)
將指定的字元(Unicode 程式碼點)轉換成其存儲在 char 陣列中的 UTF-16 表示形式。 |
static int |
toChars(int codePoint,
char[] dst,
int dstIndex)
將指定字元(Unicode 程式碼點)轉換為其 UTF-16 表示形式。 |
static int |
toCodePoint(char high,
char low)
將指定的代理項對轉換為其增補程式碼點值。 |
static char |
toLowerCase(char ch)
使用取自 UnicodeData 檔案的大小寫映射資訊將字元參數轉換為小寫。 |
static int |
toLowerCase(int codePoint)
使用取自 UnicodeData 檔案的大小寫映射資訊將字元(Unicode 程式碼點)參數轉換為小寫。 |
String |
toString()
返回表示此 Character 值的 String 物件。 |
static String |
toString(char c)
返回一個表示指定 char 值的 String 物件。 |
static char |
toTitleCase(char ch)
使用取自 UnicodeData 檔案的大小寫映射資訊將字元參數轉換為首字母大寫。 |
static int |
toTitleCase(int codePoint)
使用取自 UnicodeData 檔案的大小寫映射資訊將字元(Unicode 程式碼點)參數轉換為首字母大寫。 |
static char |
toUpperCase(char ch)
使用取自 UnicodeData 檔案的大小寫映射資訊將字元參數轉換為大寫。 |
static int |
toUpperCase(int codePoint)
使用取自 UnicodeData 檔案的大小寫映射資訊將字元(Unicode 程式碼點)參數轉換為大寫。 |
static Character |
valueOf(char c)
返回一個表示指定 char 值的 Character 實例。 |
從類別 java.lang.Object 繼承的方法 |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
欄位詳細資訊 |
---|
public static final int MIN_RADIX
Integer
類別的 digit
、forDigit
和 toString
方法)中所允許的進制參數的最小值。
digit(char, int)
,
forDigit(int, int)
,
Integer.toString(int, int)
,
Integer.valueOf(java.lang.String)
,
常數欄位值public static final int MAX_RADIX
Integer
類別的 digit
、forDigit
和 toString
方法)中所允許的進制參數的最大值。
digit(char, int)
,
forDigit(int, int)
,
Integer.toString(int, int)
,
Integer.valueOf(java.lang.String)
,
常數欄位值public static final char MIN_VALUE
char
型別的最小值,即 '\u0000'
。
public static final char MAX_VALUE
char
型別的最大值,即 '\uFFFF'
。
public static final Class<Character> TYPE
char
的 Class
實例。
public static final byte UNASSIGNED
public static final byte UPPERCASE_LETTER
public static final byte LOWERCASE_LETTER
public static final byte TITLECASE_LETTER
public static final byte MODIFIER_LETTER
public static final byte OTHER_LETTER
public static final byte NON_SPACING_MARK
public static final byte ENCLOSING_MARK
public static final byte COMBINING_SPACING_MARK
public static final byte DECIMAL_DIGIT_NUMBER
public static final byte LETTER_NUMBER
public static final byte OTHER_NUMBER
public static final byte SPACE_SEPARATOR
public static final byte LINE_SEPARATOR
public static final byte PARAGRAPH_SEPARATOR
public static final byte CONTROL
public static final byte FORMAT
public static final byte PRIVATE_USE
public static final byte SURROGATE
public static final byte DASH_PUNCTUATION
public static final byte START_PUNCTUATION
public static final byte END_PUNCTUATION
public static final byte CONNECTOR_PUNCTUATION
public static final byte OTHER_PUNCTUATION
public static final byte MATH_SYMBOL
public static final byte CURRENCY_SYMBOL
public static final byte MODIFIER_SYMBOL
public static final byte OTHER_SYMBOL
public static final byte INITIAL_QUOTE_PUNCTUATION
public static final byte FINAL_QUOTE_PUNCTUATION
public static final byte DIRECTIONALITY_UNDEFINED
char
值在 Unicode 規範中具有未定義的方向性。
public static final byte DIRECTIONALITY_LEFT_TO_RIGHT
public static final byte DIRECTIONALITY_RIGHT_TO_LEFT
public static final byte DIRECTIONALITY_RIGHT_TO_LEFT_ARABIC
public static final byte DIRECTIONALITY_EUROPEAN_NUMBER
public static final byte DIRECTIONALITY_EUROPEAN_NUMBER_SEPARATOR
public static final byte DIRECTIONALITY_EUROPEAN_NUMBER_TERMINATOR
public static final byte DIRECTIONALITY_ARABIC_NUMBER
public static final byte DIRECTIONALITY_COMMON_NUMBER_SEPARATOR
public static final byte DIRECTIONALITY_NONSPACING_MARK
public static final byte DIRECTIONALITY_BOUNDARY_NEUTRAL
public static final byte DIRECTIONALITY_PARAGRAPH_SEPARATOR
public static final byte DIRECTIONALITY_SEGMENT_SEPARATOR
public static final byte DIRECTIONALITY_WHITESPACE
public static final byte DIRECTIONALITY_OTHER_NEUTRALS
public static final byte DIRECTIONALITY_LEFT_TO_RIGHT_EMBEDDING
public static final byte DIRECTIONALITY_LEFT_TO_RIGHT_OVERRIDE
public static final byte DIRECTIONALITY_RIGHT_TO_LEFT_EMBEDDING
public static final byte DIRECTIONALITY_RIGHT_TO_LEFT_OVERRIDE
public static final byte DIRECTIONALITY_POP_DIRECTIONAL_FORMAT
public static final char MIN_HIGH_SURROGATE
public static final char MAX_HIGH_SURROGATE
public static final char MIN_LOW_SURROGATE
public static final char MAX_LOW_SURROGATE
public static final char MIN_SURROGATE
public static final char MAX_SURROGATE
public static final int MIN_SUPPLEMENTARY_CODE_POINT
public static final int MIN_CODE_POINT
public static final int MAX_CODE_POINT
public static final int SIZE
建構子詳細資訊 |
---|
public Character(char value)
Character
物件,用以表示指定的 char
值。
value
- Character
物件表示的值。方法詳細資訊 |
---|
public static Character valueOf(char c)
Character(char)
,因為該方法很可能通過快取記憶體經常請求的值來顯著提高空間和時間性能。
c
- 一個 char 值。
public char charValue()
Character
物件的值。
char
值。public int hashCode()
Character
的雜湊碼。
Object
中的 hashCode
Object.equals(java.lang.Object)
,
Hashtable
public boolean equals(Object obj)
null
,而是一個與此物件包含相同 char
值的 Character
物件時,結果才是 true
。
Object
中的 equals
obj
- 比較的物件。
true
;否則返回 false
。Object.hashCode()
,
Hashtable
public String toString()
Character
值的 String
物件。結果是一個長度為 1 的字元串,其唯一元件是此 Character
物件表示的基本 char
值。
Object
中的 toString
public static String toString(char c)
char
值的 String
物件。結果是長度為 1 的字元串,僅由指定的 char
組成。
c
- 要轉換的 char
值
char
值的字元串表示形式public static boolean isValidCodePoint(int codePoint)
0x0000
到 0x10FFFF
範圍之內的有效 Unicode 程式碼點值。該方法等效於以下表達式:
codePoint >= 0x0000 && codePoint <= 0x10FFFF
codePoint
- 要測試的 Unicode 程式碼點
true
;否則返回 false
。public static boolean isSupplementaryCodePoint(int codePoint)
codePoint >= 0x10000 && codePoint <= 0x10FFFF
codePoint
- 要測試的字元(Unicode 程式碼點)
true
;否則返回 false
。public static boolean isHighSurrogate(char ch)
char
值是否為一個高代理項程式碼單元(也稱為前導代理項程式碼單元)。這類別值並不表示它們本身的字元,而被用來表示 UTF-16 編碼中的增補字元。
該方法返回 true
的條件是當且僅當
為ch >= '\uD800' && ch <= '\uDBFF'
true
。
ch
- 要測試的 char
值。
char
值在 '\uD800' 與 '\uDBFF' 所包含的範圍之間,則返回 true
;否則返回 false
。isLowSurrogate(char)
,
Character.UnicodeBlock.of(int)
public static boolean isLowSurrogate(char ch)
char
值是否一個低代理項程式碼單元(也稱為尾部代理項程式碼單元)。這類別值並不表示它們本身的字元,而被用來表示 UTF-16 編碼中的增補字元。
該方法返回 true
的條件是當且僅當
為ch >= '\uDC00' && ch <= '\uDFFF'
true
。
ch
- 要測試的 char
值。
char
值在 '\uDC00' 與 '\uDFFF' 所包含的範圍之間,則返回 true
;否則返回 false
。isHighSurrogate(char)
public static boolean isSurrogatePair(char high, char low)
char
值對是否為有效的代理項對。該方法等效於以下表達式:
isHighSurrogate(high) && isLowSurrogate(low)
high
- 要測試的高代理項程式碼值low
- 要測試的低代理項程式碼值
true
;否則返回 false
。public static int charCount(int codePoint)
char
值的數量。如果指定字元等於或大於 0x10000,則該方法返回的值為 2。否則,該方法返回的值為 1。
該方法沒有驗證指定的字元是否為一個有效的 Unicode 程式碼點。如有必要,調用者必須使用 isValidCodePoint
驗證字元值。
codePoint
- 要測試的字元(Unicode 程式碼點)。
isSupplementaryCodePoint(int)
public static int toCodePoint(char high, char low)
isSurrogatePair
驗證它。
high
- 高代理項程式碼單元low
- 低代理項程式碼單元
public static int codePointAt(CharSequence seq, int index)
CharSequence
的給定索引上的程式碼點。如果 CharSequence
中的給定索引上的 char
值在高代理項範圍內,則下列索引的長度小於 CharSequence
的長度,如果下列索引上的 char
值在低代理項範圍內,則返回對應於此代理項對的增補程式碼點。否則,返回給定索引上的 char
值。
seq
- char
值(Unicode 程式碼單元)的序列index
- 要轉換的 seq
中的 char
值(Unicode 程式碼單元)的索引
NullPointerException
- 如果 seq
為 null。
IndexOutOfBoundsException
- 如果 index
值為負或不小於 seq.length()
。public static int codePointAt(char[] a, int index)
char
陣列的給定索引上的程式碼點。如果 char
陣列中的給定索引上的 char
值在高代理項範圍內,則下一個索引的長度小於 char
陣列的長度,如果下一個索引上的 char
值在低代理項範圍內,則返回對應於此代理項對的增補程式碼點。否則,返回給定索引上的 char
值。
a
- char
陣列index
- 要轉換的 char
陣列中的 char
值(Unicode 程式碼單元)的索引
NullPointerException
- 如果 a
為 null。
IndexOutOfBoundsException
- 如果 index
值為負或不小於 char
陣列的長度。public static int codePointAt(char[] a, int index, int limit)
char
陣列的給定索引上的程式碼點,該陣列中只有那些具有小於 limit
的 index
值的陣列元素可以使用。如果 char
陣列中的給定索引上的 char
值在高代理項範圍內,則下一個索引小於 limit
,如果下一個索引上的 char
值在低代理項範圍內,則返回對應於此代理項對的增補程式碼點。否則,返回給定索引上的 char
值。
a
- char
陣列index
- 要轉換的 char
陣列中的 char
值(Unicode 程式碼點)的索引limit
- 可以在 char
陣列中使用的最後一個陣列元素後面的索引
NullPointerException
- 如果 a
為 null。
IndexOutOfBoundsException
- 如果 index
參數為負或不小於 limit
參數,或者 limit
參數為負或大於 char
陣列的長度。public static int codePointBefore(CharSequence seq, int index)
CharSequence
的給定索引前面的程式碼點。如果 CharSequence
中的 (index - 1)
上的 char
值在低代理項範圍內,則 (index - 2)
為非負,如果 CharSequence
中的 (index - 2)
上的 char
值在高代理項範圍內,則返回對應於此代理項對的增補程式碼點。否則,返回 (index - 1)
上的 char
值。
seq
- CharSequence
實例index
- 應該返回的程式碼點後面的索引
NullPointerException
- 如果 seq
為 null。
IndexOutOfBoundsException
- 如果 index
參數小於 1 或者大於 seq.length()
。public static int codePointBefore(char[] a, int index)
char
陣列的給定索引前面的程式碼點。如果 char
陣列中的 (index - 1)
上的 char
值在低代理項範圍內,則 (index - 2)
為非負,如果 char
陣列中的 (index - 2)
上的 char
值在高代理項範圍內,則返回對應於此代理項對的增補程式碼點。否則,返回 (index - 1)
上的 char
值。
a
- char
陣列index
- 應該返回的程式碼點後面的索引
NullPointerException
- 如果 a
為 null。
IndexOutOfBoundsException
- 如果 index
參數小於 1 或大於 char
陣列的長度public static int codePointBefore(char[] a, int index, int start)
char
陣列的給定索引前面的程式碼點,該陣列中只有那些具有大於等於 start
的 index
值的陣列元素可以使用。如果 char
陣列中的 (index - 1)
上的 char
值在低代理項範圍內,則 (index - 2)
不小於 start
,如果 char
陣列中的 (index - 2)
上的 char
值在高代理項範圍內,則返回對應於此代理項對的增補程式碼點。否則,返回 (index - 1)
上的 char
值。
a
- char
陣列index
- 應該返回的程式碼點後面的索引start
- char
陣列中第一個陣列元素的索引
NullPointerException
- 如果 a
為 null。
IndexOutOfBoundsException
- 如果 index
參數不大於 start
參數或大於 char
陣列的長度,或者 start
參數為負或小於 char
陣列的長度。public static int toChars(int codePoint, char[] dst, int dstIndex)
dst[dstIndex]
中存儲相同的值,並返回 1。如果指定程式碼點是一個增補字元,則將其代理項值存儲在 dst[dstIndex]
(高代理項)和 dst[dstIndex+1]
(低代理項)中,並返回 2。
codePoint
- 要轉換的字元(Unicode 程式碼點)。dst
- char
的一個陣列,codePoint
的 UTF-16 值存儲在其中。dstIndex
- 進入存儲已轉換值的 dst
陣列中的起始索引。
IllegalArgumentException
- 如果指定的 codePoint
不是一個有效的 Unicode 程式碼點。
NullPointerException
- 如果指定的 dst
為 null。
IndexOutOfBoundsException
- 如果 dstIndex
為負或不小於 dst.length
,或者 dstIndex
上的 dst
沒有足夠多的陣列元素來存儲得到的 char
值。(如果 dstIndex
等於 dst.length-1
並且指定的 codePoint
是一個增補字元,則不在 dst[dstIndex]
中存儲高代理項值。)public static char[] toChars(int codePoint)
char
陣列中的 UTF-16 表示形式。如果指定的程式碼點是一個 BMP(Basic Multilingual Plane 或 Plane 0)值,則得到的 char
陣列具有與 codePoint
相同的值。如果指定的程式碼點是一個增補程式碼點,則得到的 char
陣列具有相應的代理項對。
codePoint
- 一個 Unicode 程式碼點
codePoint
的 UTF-16 表示形式的 char
陣列。
IllegalArgumentException
- 如果指定的 codePoint
不是一個有效的 Unicode 程式碼點。public static int codePointCount(CharSequence seq, int beginIndex, int endIndex)
beginIndex
,並擴展到索引 endIndex - 1
上的 char
。因此文本範圍的長度(char
形式)為 endIndex-beginIndex
。文本範圍內的不成對代理項是按一個程式碼點算作一個項進行計數的。
seq
- 字元序列beginIndex
- 文本範圍的第一個 char
的索引。endIndex
- 文本範圍的最後一個 char
後面的索引。
NullPointerException
- 如果 seq
為 null。
IndexOutOfBoundsException
- 如果 beginIndex
為負,或者 endIndex
大於給定序列的長度,或者 beginIndex
大於 endIndex
。public static int codePointCount(char[] a, int offset, int count)
char
陣列參數的子陣列中 Unicode 程式碼點的數量。offset
參數是子陣列的第一個 char
的索引,count
參數指定了 char
中的子陣列的長度。子陣列中不成對的代理項是按一個程式碼點算作一個項進行計數的。
a
- char
陣列offset
- 給定 char
陣列中第一個 char
的索引count
- char
中的子陣列的長度
NullPointerException
- 如果 a
為 null。
IndexOutOfBoundsException
- 如果 offset
或 count
為負,或者 offset + count
大於給定陣列的長度。public static int offsetByCodePoints(CharSequence seq, int index, int codePointOffset)
index
到 codePointOffset
程式碼點的偏移量。index
和 codePointOffset
給出的文本範圍內的不成對代理項是按一個程式碼點算作一個項進行計數的。
seq
- 字元序列index
- 要偏移的索引codePointOffset
- 程式碼點中的偏移量
NullPointerException
- 如果 seq
為 null。
IndexOutOfBoundsException
- 如果 index
為負或大於字元序列的長度,或者 codePointOffset
為負並且起始於 index
的子序列擁有的偏移量少於 codePointOffset
程式碼點,或者 codePointOffset
為負並且 index
前面的子序列的偏移量少於 codePointOffset
程式碼點的絕對值。public static int offsetByCodePoints(char[] a, int start, int count, int index, int codePointOffset)
char
子陣列中的索引,它是從給定 index
到 codePointOffset
程式碼點的偏移量。start
和 count
參數指定了 char
陣列的一個子陣列。index
和 codePointOffset
給出的文本範圍內的不成對代理項是按一個程式碼點算作一個項進行計數的。
a
- char
陣列start
- 子陣列的第一個 char
的索引count
- char
中的子陣列的長度index
- 要偏移的索引codePointOffset
- 程式碼點中的偏移量
NullPointerException
- 如果 a
為 null。
IndexOutOfBoundsException
- 如果存在以下情況:start
或 count
為負;start + count
大於給定陣列的長度;index
小於 start
或大於 start + count
;codePointOffset
為負並且起始於 index
、終止於 start + count - 1
的文本欄位的偏移量少於 codePointOffset
程式碼點;codePointOffset
為負並且起始於 start
、終止於 index - 1
的文本欄位的偏移量少於 codePointOffset
程式碼點的絕對值。public static boolean isLowerCase(char ch)
如果通過 Character.getType(ch)
提供的字元的常規類別別型別為 LOWERCASE_LETTER
,則字元為小寫字母。
以下是小寫字母的範例:
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'
其他許多 Unicode 字元也是小寫的。
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 isLowerCase(int)
方法。
ch
- 要測試的字元。
true
;否則返回 false
。isLowerCase(char)
,
isTitleCase(char)
,
toLowerCase(char)
,
getType(char)
public static boolean isLowerCase(int codePoint)
如果通過 getType(codePoint)
提供的字元的常規類別別的型別為 LOWERCASE_LETTER
,則字元為小寫字母。
以下是小寫字母的範例:
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'
其他許多 Unicode 字元也是小寫的。
codePoint
- 要測試的字元(Unicode 程式碼點)。
true
;否則返回 false
。isLowerCase(int)
,
isTitleCase(int)
,
toLowerCase(int)
,
getType(int)
public static boolean isUpperCase(char ch)
如果通過 Character.getType(ch)
提供的字元的常規類別別型別為 UPPERCASE_LETTER
,則字元為大寫字母。
以下是大寫字母的範例:
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'
其他許多 Unicode 字元也是大寫的。
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 isUpperCase(int)
方法。
ch
- 要測試的字元。
true
;否則返回 false
。isLowerCase(char)
,
isTitleCase(char)
,
toUpperCase(char)
,
getType(char)
public static boolean isUpperCase(int codePoint)
如果通過 getType(codePoint)
提供的字元的常規類別別型別為 UPPERCASE_LETTER
,則字元為大寫字母。
以下是大寫字母的範例:
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'
其他許多 Unicode 字元也是大寫的。
codePoint
- 要測試的字元(Unicode 程式碼點)。
true
;否則返回 false
。isLowerCase(int)
,
isTitleCase(int)
,
toUpperCase(int)
,
getType(int)
public static boolean isTitleCase(char ch)
如果通過 Character.getType(ch)
提供的字元的常規類別別型別為 TITLECASE_LETTER
,則字元為首字母大寫字元。
一些字元看似成對的 Latin 字母。例如,有一個看起來像“LJ”的大寫字母和一個看起來像“lj”的對應小寫字母。第三種形式看起來像“Lj”,這是呈現首字母大寫的小寫單詞時使用的適當形式,比如用於書籍的標題。
下面是一些可以讓該方法返回 true
的 Unicode 字元:
LATIN CAPITAL LETTER D WITH SMALL LETTER Z WITH CARON
LATIN CAPITAL LETTER L WITH SMALL LETTER J
LATIN CAPITAL LETTER N WITH SMALL LETTER J
LATIN CAPITAL LETTER D WITH SMALL LETTER Z
其他許多 Unicode 字元也是首字母大寫的。
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 isTitleCase(int)
方法。
ch
- 要測試的字元。
true
;否則返回 false
。isLowerCase(char)
,
isUpperCase(char)
,
toTitleCase(char)
,
getType(char)
public static boolean isTitleCase(int codePoint)
如果通過 getType(codePoint)
提供的字元的常規類別別型別為 TITLECASE_LETTER
,則字元為首字母大寫字元。
一些字元看似成對的 Latin 字母。例如,有一個看起來像“LJ”的大寫字母和一個看起來像“lj”的對應小寫字母。第三種形式看起來像“Lj”,這是呈現首字母大寫的小寫單詞時使用的適當形式,比如用於書籍的標題。
下面是一些可以讓該方法返回 true
的 Unicode 字元:
LATIN CAPITAL LETTER D WITH SMALL LETTER Z WITH CARON
LATIN CAPITAL LETTER L WITH SMALL LETTER J
LATIN CAPITAL LETTER N WITH SMALL LETTER J
LATIN CAPITAL LETTER D WITH SMALL LETTER Z
其他許多 Unicode 字元也是首字母大寫的。
codePoint
- 要測試的字元(Unicode 程式碼點)。
true
;否則返回 false
。isLowerCase(int)
,
isUpperCase(int)
,
toTitleCase(int)
,
getType(int)
public static boolean isDigit(char ch)
如果通過 Character.getType(ch)
提供的字元的常規類別別型別為 DECIMAL_DIGIT_NUMBER
,則字元為數字。
包含數字的 Unicode 字元範圍:
'\u0030'
到 '\u0039'
,ISO-LATIN-1 數字('0'
到 '9'
)
'\u0660'
到 '\u0669'
,Arabic-Indic 數字
'\u06F0'
到 '\u06F9'
,擴展了的 Arabic-Indic 數字
'\u0966'
到 '\u096F'
,梵文數字
'\uFF10'
到 '\uFF19'
,全形數字
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 isDigit(int)
方法。
ch
- 要測試的字元。
true
;否則返回 false
。digit(char, int)
,
forDigit(int, int)
,
getType(char)
public static boolean isDigit(int codePoint)
如果通過 getType(codePoint)
提供的字元的常規類別別型別為 DECIMAL_DIGIT_NUMBER
,則字元為數字。
包含數字的 Unicode 字元範圍:
'\u0030'
到 '\u0039'
,ISO-LATIN-1 數字('0'
到 '9'
)
'\u0660'
到 '\u0669'
,Arabic-Indic 數字
'\u06F0'
到 '\u06F9'
,擴展了的 Arabic-Indic 數字
'\u0966'
到 '\u096F'
,梵文數字
'\uFF10'
到 '\uFF19'
,全形數字
codePoint
- 要測試的字元(Unicode 程式碼點)。
true
;否則返回 false
。forDigit(int, int)
,
getType(int)
public static boolean isDefined(char ch)
如果以下條件中至少有一個為真,則字元被定義為 Unicode 中的字元:
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 isDefined(int)
方法。
ch
- 要測試的字元
true
;否則返回 false
。isDigit(char)
,
isLetter(char)
,
isLetterOrDigit(char)
,
isLowerCase(char)
,
isTitleCase(char)
,
isUpperCase(char)
public static boolean isDefined(int codePoint)
如果以下條件中至少有一個為真,則字元被定義為 Unicode 中的字元:
codePoint
- 要測試的字元(Unicode 程式碼點)。
true
;否則返回 false
。isDigit(int)
,
isLetter(int)
,
isLetterOrDigit(int)
,
isLowerCase(int)
,
isTitleCase(int)
,
isUpperCase(int)
public static boolean isLetter(char ch)
如果通過 Character.getType(ch)
為字元提供的常規類別別的型別為以下型別中的任意一種,則認為該字元為字母:
UPPERCASE_LETTER
LOWERCASE_LETTER
TITLECASE_LETTER
MODIFIER_LETTER
OTHER_LETTER
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 isLetter(int)
方法。
ch
- 要測試的字元。
true
;否則返回 false
。isDigit(char)
,
isJavaIdentifierStart(char)
,
isJavaLetter(char)
,
isJavaLetterOrDigit(char)
,
isLetterOrDigit(char)
,
isLowerCase(char)
,
isTitleCase(char)
,
isUnicodeIdentifierStart(char)
,
isUpperCase(char)
public static boolean isLetter(int codePoint)
如果通過 getType(codePoint)
為字元提供的常規類別別的型別為以下型別中的任意一種,則認為該字元為字母:
UPPERCASE_LETTER
LOWERCASE_LETTER
TITLECASE_LETTER
MODIFIER_LETTER
OTHER_LETTER
codePoint
- 要測試的字元(Unicode 程式碼點)。
true
;否則返回 false
。isDigit(int)
,
isJavaIdentifierStart(int)
,
isLetterOrDigit(int)
,
isLowerCase(int)
,
isTitleCase(int)
,
isUnicodeIdentifierStart(int)
,
isUpperCase(int)
public static boolean isLetterOrDigit(char ch)
如果 Character.isLetter(char ch)
或 Character.isDigit(char ch)
對字元返回的是 true
,則認為字元是一個字母或數字。
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 isLetterOrDigit(int)
方法。
ch
- 要測試的字元。
true
;否則返回 false
。isDigit(char)
,
isJavaIdentifierPart(char)
,
isJavaLetter(char)
,
isJavaLetterOrDigit(char)
,
isLetter(char)
,
isUnicodeIdentifierPart(char)
public static boolean isLetterOrDigit(int codePoint)
如果 isLetter(codePoint)
或 isDigit(codePoint)
對字元返回的是 true
,則認為字元是一個字母或數字。
codePoint
- 要測試的字元(Unicode 程式碼點)。
true
;否則返回 false
。isDigit(int)
,
isJavaIdentifierPart(int)
,
isLetter(int)
,
isUnicodeIdentifierPart(int)
@Deprecated public static boolean isJavaLetter(char ch)
當且僅當以下條件之一為真時,字元才可以作為 Java 標識符的首字母:
isLetter(ch)
返回 true
getType(ch)
返回 LETTER_NUMBER
ch
- 要測試的字元。
true
;否則返回 false
。isJavaLetterOrDigit(char)
,
isJavaIdentifierStart(char)
,
isJavaIdentifierPart(char)
,
isLetter(char)
,
isLetterOrDigit(char)
,
isUnicodeIdentifierStart(char)
@Deprecated public static boolean isJavaLetterOrDigit(char ch)
當且僅當以下任何條件為真時,字元才可能是 Java 標識符的一部分:
'$'
)
'_'
)。
isIdentifierIgnorable
對字元返回的是 true
。
ch
- 要測試的字元。
true
;否則返回 false
。isJavaLetter(char)
,
isJavaIdentifierStart(char)
,
isJavaIdentifierPart(char)
,
isLetter(char)
,
isLetterOrDigit(char)
,
isUnicodeIdentifierPart(char)
,
isIdentifierIgnorable(char)
public static boolean isJavaIdentifierStart(char ch)
當且僅當以下條件之一為真時,字元才可以作為 Java 標識符的首字元:
isLetter(ch)
返回 true
getType(ch)
返回 LETTER_NUMBER
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 isJavaIdentifierStart(int)
方法。
ch
- 要測試的字元。
true
;否則返回 false
。isJavaIdentifierPart(char)
,
isLetter(char)
,
isUnicodeIdentifierStart(char)
,
SourceVersion.isIdentifier(CharSequence)
public static boolean isJavaIdentifierStart(int codePoint)
當且僅當以下條件之一為真時,字元才可以作為 Java 標識符的首字元:
isLetter(codePoint)
返回 true
getType(codePoint)
返回 LETTER_NUMBER
codePoint
- 要測試的字元(Unicode 程式碼點)。
true
;否則返回 false
。isJavaIdentifierPart(int)
,
isLetter(int)
,
isUnicodeIdentifierStart(int)
,
SourceVersion.isIdentifier(CharSequence)
public static boolean isJavaIdentifierPart(char ch)
如果以下任何條件為真,那麼字元可能是 Java 標識符的一部分:
'$'
)
'_'
)。
isIdentifierIgnorable
對字元返回的是 true
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 isJavaIdentifierPart(int)
方法。
ch
- 要測試的字元。
true
;否則返回 false
。isIdentifierIgnorable(char)
,
isJavaIdentifierStart(char)
,
isLetterOrDigit(char)
,
isUnicodeIdentifierPart(char)
,
SourceVersion.isIdentifier(CharSequence)
public static boolean isJavaIdentifierPart(int codePoint)
如果以下任何條件為真,那麼字元可能是 Java 標識符的一部分:
'$'
)
'_'
)。
isIdentifierIgnorable(codePoint)
對字元返回的是 true
codePoint
- 要測試的字元(Unicode 程式碼點)。
true
;否則返回 false
。isIdentifierIgnorable(int)
,
isJavaIdentifierStart(int)
,
isLetterOrDigit(int)
,
isUnicodeIdentifierPart(int)
,
SourceVersion.isIdentifier(CharSequence)
public static boolean isUnicodeIdentifierStart(char ch)
當且僅當以下條件之一為真時,字元才可以作為 Unicode 標識符的首字元:
isLetter(ch)
返回 true
getType(ch)
返回 LETTER_NUMBER
。
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 isUnicodeIdentifierStart(int)
方法。
ch
- 要測試的字元。
true
;否則返回 false
。isJavaIdentifierStart(char)
,
isLetter(char)
,
isUnicodeIdentifierPart(char)
public static boolean isUnicodeIdentifierStart(int codePoint)
當且僅當以下條件之一為真時,字元才可以作為 Unicode 標識符的首字元:
isLetter(codePoint)
返回 true
getType(codePoint)
返回 LETTER_NUMBER
。
codePoint
- 要測試的字元(Unicode 程式碼點)。
true
;否則返回 false
。isJavaIdentifierStart(int)
,
isLetter(int)
,
isUnicodeIdentifierPart(int)
public static boolean isUnicodeIdentifierPart(char ch)
當且僅當以下語句之一為真時,字元才可能是 Unicode 標識符的一部分:
'_'
)。
isIdentifierIgnorable
對該字元返回的是 true
。
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 isUnicodeIdentifierPart(int)
方法。
ch
- 要測試的字元。
true
;否則返回 false
。isIdentifierIgnorable(char)
,
isJavaIdentifierPart(char)
,
isLetterOrDigit(char)
,
isUnicodeIdentifierStart(char)
public static boolean isUnicodeIdentifierPart(int codePoint)
當且僅當以下語句之一為真時,字元才可能是 Unicode 標識符的一部分:
'_'
)。
isIdentifierIgnorable
對該字元返回的是 true
。
codePoint
- 要測試的字元(Unicode 程式碼點)。
true
;否則返回 false
。isIdentifierIgnorable(int)
,
isJavaIdentifierPart(int)
,
isLetterOrDigit(int)
,
isUnicodeIdentifierStart(int)
public static boolean isIdentifierIgnorable(char ch)
以下 Unicode 字元是 Java 標識符或 Unicode 標識符中可忽略的字元:
'\u0000'
到 '\u0008'
'\u000E'
到 '\u001B'
'\u007F'
到 '\u009F'
FORMAT
常規類別別值的所有字元
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 isIdentifierIgnorable(int)
方法。
ch
- 要測試的字元。
true
;否則返回 false
。isJavaIdentifierPart(char)
,
isUnicodeIdentifierPart(char)
public static boolean isIdentifierIgnorable(int codePoint)
以下 Unicode 字元是 Java 標識符或 Unicode 標識符中可忽略的字元:
'\u0000'
到 '\u0008'
'\u000E'
到 '\u001B'
'\u007F'
到 '\u009F'
FORMAT
常規類別別值的所有字元
codePoint
- 要測試的字元(Unicode 程式碼點)。
true
;否則返回 false
。isJavaIdentifierPart(int)
,
isUnicodeIdentifierPart(int)
public static char toLowerCase(char ch)
注意,對於某些範圍內的字元,特別是那些是符號或表意符號的字元,Character.isLowerCase(Character.toLowerCase(ch))
並不總是返回 true
。
通常,應該使用 String.toLowerCase()
將字元映射為小寫。String
大小寫映射方法有幾個勝過 Character
大小寫映射方法的優點。String
大小寫映射方法可以執行語言環境敏感的映射、上下文相關的映射和 1:M 字元映射,而 Character
大小寫映射方法卻不能。
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 toLowerCase(int)
方法。
ch
- 要轉換的字元。
isLowerCase(char)
,
String.toLowerCase()
public static int toLowerCase(int codePoint)
注意,對於某些範圍內的字元,特別是那些是符號或表意符號的字元,Character.isLowerCase(Character.toLowerCase(codePoint))
並不總是返回 true
。
通常,應該使用 String.toLowerCase()
將字元映射為小寫。String
大小寫映射方法有幾個勝過 Character
大小寫映射方法的優點。String
大小寫映射方法可以執行語言環境敏感的映射、上下文相關的映射和 1:M 字元映射,而 Character
大小寫映射方法卻不能。
codePoint
- 要轉換的字元(Unicode 程式碼點)。
isLowerCase(int)
,
String.toLowerCase()
public static char toUpperCase(char ch)
注意,對於某些範圍內的字元,特別是那些是符號或表意符號的字元,Character.isUpperCase(Character.toUpperCase(ch))
並不總是返回 true
。
通常,應該使用 String.toUpperCase()
將字元映射為大寫。String
大小寫映射方法有幾個勝過 Character
大小寫映射方法的優點。String
大小寫映射方法可以執行語言環境敏感的映射、上下文相關的映射和 1:M 字元映射,而 Character
大小寫映射方法卻不能。
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 toUpperCase(int)
方法。
ch
- 要轉換的字元。
isUpperCase(char)
,
String.toUpperCase()
public static int toUpperCase(int codePoint)
注意,對於某些範圍內的字元,特別是那些是符號或表意符號的字元,Character.isUpperCase(Character.toUpperCase(codePoint))
並不總是返回 true
。
通常,應該使用 String.toUpperCase()
將字元映射為大寫。String
大小寫映射方法有幾個勝過 Character
大小寫映射方法的優點。String
大小寫映射方法可以執行語言環境敏感的映射、上下文相關的映射和 1:M 字元映射,而 Character
大小寫映射方法卻不能。
codePoint
- 要轉換的字元(Unicode 程式碼點)。
isUpperCase(int)
,
String.toUpperCase()
public static char toTitleCase(char ch)
char
參數總是一個首字母大寫的 char
,則返回相同的 char
值。
注意,對於某些範圍內的字元,Character.isTitleCase(Character.toTitleCase(ch))
並不總是返回 true
。
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 toTitleCase(int)
方法。
ch
- 要轉換的字元。
isTitleCase(char)
,
toLowerCase(char)
,
toUpperCase(char)
public static int toTitleCase(int codePoint)
注意,對於某些範圍內的字元,Character.isTitleCase(Character.toTitleCase(codePoint))
並不總是返回 true
。
codePoint
- 要轉換的字元(Unicode 程式碼點)。
isTitleCase(int)
,
toLowerCase(int)
,
toUpperCase(int)
public static int digit(char ch, int radix)
ch
的數值。
如果進制不在 MIN_RADIX
<= radix
<= MAX_RADIX
範圍之內,或者 ch
的值是一個使用指定進制的無效數字,則返回 -1
。如果以下條件中至少有一個為真,則字元是一個有效數字:
isDigit
為 true
,且字元(或分解的單字元)的 Unicode 十進制數值小於指定的進制。在這種情況下,返回十進制數值。
'A'
到 'Z'
範圍內的大寫拉丁字母之一,且它的程式碼小於 radix + 'A' - 10
。在這種情況下,返回 ch - 'A' + 10
。
'a'
到 'z'
範圍內的小寫拉丁字母之一,且它的程式碼小於 radix + 'a' - 10
。在這種情況下,返回 ch - 'a' + 10
。
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 digit(int, int)
方法。
ch
- 要轉換的字元。radix
- 進制。
forDigit(int, int)
,
isDigit(char)
public static int digit(int codePoint, int radix)
如果進制不在 MIN_RADIX
<= radix
<= MAX_RADIX
範圍之內,或者字元是一個使用指定進制的無效數字,則返回 -1
。如果以下條件中至少有一個為真,則字元是一個有效數字:
isDigit(codePoint)
為 true
,且字元(或分解的單字元)的 Unicode 十進制數值小於指定的進制。在這種情況下,返回十進制數值。
'A'
到 'Z'
範圍內的大寫拉丁字母之一,且它的程式碼小於 radix + 'A' - 10
。在這種情況下,返回 ch - 'A' + 10
。
'a'
到 'z'
範圍內的小寫拉丁字母之一,且它的程式碼小於 radix + 'a' - 10
。在這種情況下,返回 ch - 'a' + 10
。
codePoint
- 要轉換的字元(Unicode 程式碼點)。radix
- 進制。
forDigit(int, int)
,
isDigit(int)
public static int getNumericValue(char ch)
int
值。例如,字元 '\u216C'
(羅馬數字 50)將返回一個值為 50 的整數。
字母 A-Z 的大寫('\u0041'
到 '\u005A'
)、小寫('\u0061'
到 '\u007A'
)和全形參數('\uFF21'
到 '\uFF3A'
和 '\uFF41'
到 '\uFF5A'
)形式擁有從 10 到 35 的數值。這獨立於 Unicode 規範,該規範沒有為這些 char
值分派數值。
如果字元中沒有數值,則返回 -1。如果字元中有一個數值,但無法將它表示為非負整數(例如,小數值),則返回 -2。
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 getNumericValue(int)
方法。
ch
- 要轉換的字元。
int
值形式返回字元的數值;如果字元中有一個不是非負整數的數值,則返回 -2;如果字元中沒有數值,則返回 -1。forDigit(int, int)
,
isDigit(char)
public static int getNumericValue(int codePoint)
int
值。例如,字元 '\u216C'
(羅馬數字 50)將返回一個值為 50 的 int
值。
字母 A-Z 的大寫('\u0041'
到 '\u005A'
)、小寫('\u0061'
到 '\u007A'
)和全形參數('\uFF21'
到 '\uFF3A'
和 '\uFF41'
到 '\uFF5A'
)形式擁有從 10 到 35 的數值。這獨立於 Unicode 規範,該規範沒有為這些 char
值分派數值。
如果字元中沒有數字值,則返回 -1。如果字元中有一個數值,但無法將它表示為非負整數(例如,小數值),則返回 -2。
codePoint
- 要轉換的字元(Unicode 程式碼點)。
int
值形式返回字元的數值;如果字元中有一個不是非負整數的數值,則返回 -2;如果字元中沒有數值,則返回 -1。forDigit(int, int)
,
isDigit(int)
@Deprecated public static boolean isSpace(char ch)
true
:
'\t' | '\u0009' |
HORIZONTAL TABULATION |
'\n' | '\u000A' |
NEW LINE |
'\f' | '\u000C' |
FORM FEED |
'\r' | '\u000D' |
CARRIAGE RETURN |
' ' | '\u0020' |
SPACE |
ch
- 要測試的字元。
true
;否則返回 false
。isSpaceChar(char)
,
isWhitespace(char)
public static boolean isSpaceChar(char ch)
SPACE_SEPARATOR
LINE_SEPARATOR
PARAGRAPH_SEPARATOR
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 isSpaceChar(int)
方法。
ch
- 要測試的字元。
true
;否則返回 false
。isWhitespace(char)
public static boolean isSpaceChar(int codePoint)
codePoint
- 要測試的字元(Unicode 程式碼點)。
true
;否則返回 false
。isWhitespace(int)
public static boolean isWhitespace(char ch)
SPACE_SEPARATOR
、LINE_SEPARATOR
或 PARAGRAPH_SEPARATOR
),但不是非中斷空格('\u00A0'
、'\u2007'
、'\u202F'
)
'\u0009'
,HORIZONTAL TABULATION
'\u000A'
,LINE FEED
'\u000B'
,VERTICAL TABULATION
'\u000C'
,FORM FEED
'\u000D'
,CARRIAGE RETURN
'\u001C'
,FILE SEPARATOR
'\u001D'
,GROUP SEPARATOR
'\u001E'
,RECORD SEPARATOR
'\u001F'
,UNIT SEPARATOR
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 isWhitespace(int)
方法。
ch
- 要測試的字元。
true
;否則返回 false
。isSpaceChar(char)
public static boolean isWhitespace(int codePoint)
SPACE_SEPARATOR
、LINE_SEPARATOR
或 PARAGRAPH_SEPARATOR
),但不是一個不間斷空格('\u00A0'
、'\u2007'
和 '\u202F'
)。
'\u0009'
,水平製表符。
'\u000A'
,換行。
'\u000B'
,縱向製表符。
'\u000C'
,換頁。
'\u000D'
,回車(Enter)。
'\u001C'
,檔案分隔符。
'\u001D'
,組分隔符。
'\u001E'
,記錄分隔符。
'\u001F'
,單元分隔符。
codePoint
- 要測試的字元(Unicode 程式碼點)。
true
;否則返回 false
。isSpaceChar(int)
public static boolean isISOControl(char ch)
'\u0000'
到 '\u001F'
或從 '\u007F'
到 '\u009F'
的範圍內,則認為該字元是一個 ISO 控制字元。
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 isISOControl(int)
方法。
ch
- 要測試的字元。
true
;否則返回 false
。isSpaceChar(char)
,
isWhitespace(char)
public static boolean isISOControl(int codePoint)
'\u0000'
到 '\u001F'
或從 '\u007F'
到 '\u009F'
的範圍內,則認為該字元是一個 ISO 控制字元。
codePoint
- 要測試的字元(Unicode 程式碼點)。
true
;否則返回 false
。isSpaceChar(int)
,
isWhitespace(int)
public static int getType(char ch)
註: 此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 getType(int)
方法。
ch
- 要測試的字元。
int
型別的值。COMBINING_SPACING_MARK
,
CONNECTOR_PUNCTUATION
,
CONTROL
,
CURRENCY_SYMBOL
,
DASH_PUNCTUATION
,
DECIMAL_DIGIT_NUMBER
,
ENCLOSING_MARK
,
END_PUNCTUATION
,
FINAL_QUOTE_PUNCTUATION
,
FORMAT
,
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
public static int getType(int codePoint)
codePoint
- 要測試的字元(Unicode 程式碼點)。
int
型別的值。COMBINING_SPACING_MARK
,
CONNECTOR_PUNCTUATION
,
CONTROL
,
CURRENCY_SYMBOL
,
DASH_PUNCTUATION
,
DECIMAL_DIGIT_NUMBER
,
ENCLOSING_MARK
,
END_PUNCTUATION
,
FINAL_QUOTE_PUNCTUATION
,
FORMAT
,
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
public static char forDigit(int digit, int radix)
radix
的值不是一個有效進制,或者 digit
的值不是一個使用指定進制的有效數字,則返回 null 字元('\u0000'
)。
如果 radix
參數大於等於 MIN_RADIX
並且小於等於 MAX_RADIX
,則該參數是有效的。如果 0 <=digit < radix
,則 digit
參數是有效的。
如果數字小於 10,則返回 '0' + digit
。否則,返回的值為 'a' + digit - 10
。
digit
- 轉換為字元的數字。radix
- 進制。
char
表示形式。MIN_RADIX
,
MAX_RADIX
,
digit(char, int)
public static byte getDirectionality(char ch)
char
值的方向值是 DIRECTIONALITY_UNDEFINED
。
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 getDirectionality(int)
方法。
ch
- 為其請求方向屬性的 char
。
char
值的方向屬性。DIRECTIONALITY_UNDEFINED
,
DIRECTIONALITY_LEFT_TO_RIGHT
,
DIRECTIONALITY_RIGHT_TO_LEFT
,
DIRECTIONALITY_RIGHT_TO_LEFT_ARABIC
,
DIRECTIONALITY_EUROPEAN_NUMBER
,
DIRECTIONALITY_EUROPEAN_NUMBER_SEPARATOR
,
DIRECTIONALITY_EUROPEAN_NUMBER_TERMINATOR
,
DIRECTIONALITY_ARABIC_NUMBER
,
DIRECTIONALITY_COMMON_NUMBER_SEPARATOR
,
DIRECTIONALITY_NONSPACING_MARK
,
DIRECTIONALITY_BOUNDARY_NEUTRAL
,
DIRECTIONALITY_PARAGRAPH_SEPARATOR
,
DIRECTIONALITY_SEGMENT_SEPARATOR
,
DIRECTIONALITY_WHITESPACE
,
DIRECTIONALITY_OTHER_NEUTRALS
,
DIRECTIONALITY_LEFT_TO_RIGHT_EMBEDDING
,
DIRECTIONALITY_LEFT_TO_RIGHT_OVERRIDE
,
DIRECTIONALITY_RIGHT_TO_LEFT_EMBEDDING
,
DIRECTIONALITY_RIGHT_TO_LEFT_OVERRIDE
,
DIRECTIONALITY_POP_DIRECTIONAL_FORMAT
public static byte getDirectionality(int codePoint)
DIRECTIONALITY_UNDEFINED
。
codePoint
- 為其請求方向屬性的字元(Unicode 程式碼點)。
DIRECTIONALITY_UNDEFINED
,
DIRECTIONALITY_LEFT_TO_RIGHT
,
DIRECTIONALITY_RIGHT_TO_LEFT
,
DIRECTIONALITY_RIGHT_TO_LEFT_ARABIC
,
DIRECTIONALITY_EUROPEAN_NUMBER
,
DIRECTIONALITY_EUROPEAN_NUMBER_SEPARATOR
,
DIRECTIONALITY_EUROPEAN_NUMBER_TERMINATOR
,
DIRECTIONALITY_ARABIC_NUMBER
,
DIRECTIONALITY_COMMON_NUMBER_SEPARATOR
,
DIRECTIONALITY_NONSPACING_MARK
,
DIRECTIONALITY_BOUNDARY_NEUTRAL
,
DIRECTIONALITY_PARAGRAPH_SEPARATOR
,
DIRECTIONALITY_SEGMENT_SEPARATOR
,
DIRECTIONALITY_WHITESPACE
,
DIRECTIONALITY_OTHER_NEUTRALS
,
DIRECTIONALITY_LEFT_TO_RIGHT_EMBEDDING
,
DIRECTIONALITY_LEFT_TO_RIGHT_OVERRIDE
,
DIRECTIONALITY_RIGHT_TO_LEFT_EMBEDDING
,
DIRECTIONALITY_RIGHT_TO_LEFT_OVERRIDE
,
DIRECTIONALITY_POP_DIRECTIONAL_FORMAT
public static boolean isMirrored(char ch)
'\u0028'
LEFT PARENTHESIS 在語義上被定義為是開括號。在從左至右顯示的文本中,它將顯示為“(”,但在以從右至左的方式顯示的文本中,它顯示為“)”。
註:此方法無法處理增補字元。若要支持所有 Unicode 字元,包括增補字元,請使用 isMirrored(int)
方法。
ch
- 為其請求對稱屬性的 char
true
,如果 char
不是對稱的或者尚未定義,則返回 false
。public static boolean isMirrored(int codePoint)
'\u0028'
LEFT PARENTHESIS 在語義上被定義為是開括號。在從左至右顯示的文本中,它將顯示為“(”,但在以從右至左的方式顯示的文本中,它顯示為“)”。
codePoint
- 要測試的字元(Unicode 程式碼點)。
true
,如果字元是不對稱的或者尚未定義,則返回 false
。public int compareTo(Character anotherCharacter)
Character
物件。
Comparable<Character>
中的 compareTo
anotherCharacter
- 要比較的 Character
。
Character
等於此 Character
,則返回 0
;如果該 Character
的數值小於參數 Character
,則返回小於 0
的值;如果該 Character
的數值大於參數 Character
,則返回大於 0
的值(有符號比較)。注意,這是一次嚴格的數字比較;它並不依賴於區域。public static char reverseBytes(char ch)
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一個類別 下一個類別 | 框架 無框架 | |||||||||
摘要: 巢狀 | 欄位 | 建構子 | 方法 | 詳細資訊: 欄位 | 建構子 | 方法 |
版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。