鴻蒙OS StringJoiner

2022-08-09 11:15 更新

StringJoiner

java.lang.Object

|---java.util.StringJoiner

public final class StringJoiner
extends Object

StringJoiner 用于構造由分隔符分隔的字符序列,并且可以選擇以提供的前綴開頭并以提供的后綴結尾。

在向 StringJoiner 添加內容之前,它的 sj.toString() 方法將默認返回前綴 + 后綴。 但是,如果調用 setEmptyValue 方法,則將返回提供的 emptyValue。 例如,當使用集合表示法創(chuàng)建一個字符串以指示一個空集合時,即“{}”,其中前綴是“{”,后綴是“}”并且沒有任何內容添加到 StringJoiner 時,可以使用它。

構造函數(shù)摘要

構造函數(shù) 描述
StringJoiner(CharSequence delimiter) 構造一個其中沒有字符、沒有前綴或后綴的 StringJoiner,以及提供的分隔符的副本。
StringJoiner(CharSequence delimiter, CharSequence prefix, CharSequence suffix) 使用提供的前綴、分隔符和后綴的副本構造一個其中沒有字符的 StringJoiner。

方法總結

修飾符和類型 方法 描述
StringJoiner add(CharSequence newElement) 添加給定 CharSequence 值的副本作為 StringJoiner 值的下一個元素。
int length() 返回此 StringJoiner 的字符串表示形式的長度。
StringJoiner merge(StringJoiner other) 如果給定的 StringJoiner 不為空,則添加不帶前綴和后綴的內容作為下一個元素。
StringJoiner setEmptyValue(CharSequence emptyValue) 設置在確定此 StringJoiner 的字符串表示且尚未添加任何元素(即為空時)時要使用的字符序列。
String toString() 返回當前值,由前綴、到目前為止添加的由分隔符分隔的值和后綴組成,除非沒有添加任何元素,在這種情況下,返回前綴 + 后綴或 emptyValue 字符
從類 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

構造函數(shù)詳細信息

StringJoiner

public StringJoiner(CharSequence delimiter)

構造一個其中沒有字符、沒有前綴或后綴的 StringJoiner,以及提供的分隔符的副本。 如果沒有字符被添加到 StringJoiner 并且調用訪問它的值的方法,它將不會在結果中返回前綴或后綴(或其屬性),除非首先調用了 setEmptyValue。

參數(shù):

參數(shù)名稱 參數(shù)描述
delimiter 添加到 StringJoiner 值的每個元素之間要使用的字符序列

Throws:

Throw名稱 Throw描述
NullPointerException 如果分隔符為空

StringJoiner

public StringJoiner(CharSequence delimiter, CharSequence prefix, CharSequence suffix)

使用提供的前綴、分隔符和后綴的副本構造一個其中沒有字符的 StringJoiner。 如果沒有字符被添加到 StringJoiner 并且調用了訪問它的字符串值的方法,它將在結果中返回前綴 + 后綴(或其屬性),除非首先調用了 setEmptyValue。

參數(shù):

參數(shù)名稱 參數(shù)描述
delimiter 添加到 StringJoiner 的每個元素之間要使用的字符序列
prefix 開頭使用的字符序列
suffix 最后要使用的字符序列

Throws:

Throw名稱 Throw描述
NullPointerException 如果前綴、分隔符或后綴為空

方法詳情

setEmptyValue

public StringJoiner setEmptyValue(CharSequence emptyValue)

設置在確定此 StringJoiner 的字符串表示且尚未添加任何元素(即為空時)時要使用的字符序列。 為此目的制作了一個emptyValue 參數(shù)的副本。 請注意,一旦調用了 add 方法,即使添加的元素對應于空字符串,StringJoiner 也不再被視為空。

參數(shù):

參數(shù)名稱 參數(shù)描述
emptyValue 作為空 StringJoiner 的值返回的字符

返回:

這個 StringJoiner 本身,所以調用可能會被鏈接

Throws:

Throw名稱 Throw描述
NullPointerException 當 emptyValue 參數(shù)為 null

toString

public String toString()

返回當前值,由前綴、到目前為止添加的由分隔符分隔的值和后綴組成,除非沒有添加任何元素,在這種情況下,返回前綴 + 后綴或 emptyValue 字符

覆蓋:

類 Object 中的 toString

返回:

此 StringJoiner 的字符串表示形式

add

public StringJoiner add(CharSequence newElement)

添加給定 CharSequence 值的副本作為 StringJoiner 值的下一個元素。 如果 newElement 為 null,則添加“null”。

參數(shù):

參數(shù)名稱 參數(shù)描述
newElement 要添加的元素

返回:

對此 StringJoiner 的引用

merge

public StringJoiner merge(StringJoiner other)

如果給定的 StringJoiner 不為空,則添加不帶前綴和后綴的內容作為下一個元素。 如果給定的 StringJoiner 為空,則調用無效。

如果從未調用過 add(),并且從未使用非空 StringJoiner 參數(shù)調用過 merge(),則 StringJoiner 為空。

如果另一個 StringJoiner 使用不同的定界符,則來自另一個 StringJoiner 的元素與該定界符連接,并將結果作為單個元素附加到此 StringJoiner。

參數(shù):

參數(shù)名稱 參數(shù)描述
other 內容應該合并到這個的 StringJoiner

返回:

這個 StringJoiner

Throws:

Throw名稱 Throw描述
NullPointerException 如果另一個 StringJoiner 為空

length

public int length()

返回此 StringJoiner 的字符串表示形式的長度。 請注意,如果未調用任何 add 方法,則將返回字符串表示的長度(前綴 + 后綴或空值)。 該值應等同于 toString().length()。

返回:

StringJoiner 的當前值的長度

以上內容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號