鴻蒙OS CharSequence

2022-04-28 16:35 更新

CharSequence

public interface CharSequence

CharSequence 是一個可讀的 char 值序列。 此接口提供對許多不同類型的字符序列的統(tǒng)一只讀訪問。 char 值表示基本多語言平面 (BMP) 中的字符或代理項。

這個接口沒有細(xì)化 equals 和 hashCode 方法的一般契約。 因此,比較實現(xiàn) CharSequence 的兩個對象的結(jié)果通常是未定義的。 每個對象都可以由不同的類實現(xiàn),并且不能保證每個類都能夠測試其實例與其他類的實例是否相等。 因此,將任意 CharSequence 實例用作集合中的元素或映射中的鍵是不合適的。

方法總結(jié)

修飾符和類型 方法 描述
char charAt(int index) 返回指定索引處的 char 值。
default IntStream chars() 返回一個 int 流,對該序列中的 char 值進(jìn)行零擴(kuò)展。
default IntStream codePoints() 從該序列返回代碼點值流。
int length() 返回此字符序列的長度。
CharSequence subSequence(int start, int end) 返回作為此序列子序列的 CharSequence。
String toString() 以與此序列相同的順序返回包含此序列中字符的字符串。

方法詳情

length

int length()

返回此字符序列的長度。 長度是序列中 16 位字符的數(shù)量。

返回:

此序列中的字符數(shù)

charAt

char charAt(int index)

返回指定索引處的 char 值。 索引范圍從零到 length() - 1。序列的第一個 char 值在索引 0 處,下一個在索引 1 處,依此類推,與數(shù)組索引一樣。

如果索引指定的 char 值是代理項,則返回代理項值。

參數(shù):

參數(shù)名稱 參數(shù)描述
index 要返回的 char 值的索引

返回:

指定的字符值

Throws:

Throw名稱 Throw描述
IndexOutOfBoundsException 如果 index 參數(shù)為負(fù)數(shù)或不小于 length()

subSequence

CharSequence subSequence(int start, int end)

返回作為此序列子序列的 CharSequence。 子序列以指定索引處的 char 值開始,以索引 end - 1 處的 char 值結(jié)束。返回序列的長度(以字符為單位)為 end - start,因此如果 start == end 則返回空序列 .

參數(shù):

參數(shù)名稱 參數(shù)描述
start 起始索引,包括
end 結(jié)束索引,獨占

返回:

指定的子序列

Throws:

Throw名稱 Throw描述
IndexOutOfBoundsException 如果 start 或 end 為負(fù)數(shù),如果 end 大于 length(),或者如果 start 大于 end

toString

String toString()

以與此序列相同的順序返回包含此序列中字符的字符串。 字符串的長度就是這個序列的長度。

覆蓋:

類 Object 中的 toString

返回:

正好由這個字符序列組成的字符串

chars

default IntStream chars()

返回一個 int 流,對該序列中的 char 值進(jìn)行零擴(kuò)展。 任何映射到代理代碼點的字符都會未經(jīng)解釋地傳遞。

如果在讀取流時序列發(fā)生突變,則結(jié)果未定義。

返回:

來自此序列的 char 值的 IntStream

codePoints

default IntStream codePoints()

從該序列返回代碼點值流。 序列中遇到的任何代理對都被組合起來,就像通過 Character#toCodePoint 一樣,并將結(jié)果傳遞給流。 任何其他代碼單元,包括普通 BMP 字符、不成對的代理和未定義的代碼單元,都被零擴(kuò)展為 int 值,然后將其傳遞給流。

如果在讀取流時序列發(fā)生突變,則結(jié)果未定義。

返回:

來自此序列的 Unicode 代碼點的 IntStream

以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號