W3Cschool
恭喜您成為首批注冊用戶
獲得88經驗值獎勵
java.lang.Object
|---java.util.StringJoiner
public final class StringJoiner
extends Object
StringJoiner 用于構造由分隔符分隔的字符序列,并且可以選擇以提供的前綴開頭并以提供的后綴結尾。
在向 StringJoiner 添加內容之前,它的 sj.toString() 方法將默認返回前綴 + 后綴。 但是,如果調用 setEmptyValue 方法,則將返回提供的 emptyValue。 例如,當使用集合表示法創(chuàng)建一個字符串以指示一個空集合時,即“{}”,其中前綴是“{”,后綴是“}”并且沒有任何內容添加到 StringJoiner 時,可以使用它。
構造函數(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 |
public StringJoiner(CharSequence delimiter)
構造一個其中沒有字符、沒有前綴或后綴的 StringJoiner,以及提供的分隔符的副本。 如果沒有字符被添加到 StringJoiner 并且調用訪問它的值的方法,它將不會在結果中返回前綴或后綴(或其屬性),除非首先調用了 setEmptyValue。
參數(shù):
參數(shù)名稱 | 參數(shù)描述 |
---|---|
delimiter | 添加到 StringJoiner 值的每個元素之間要使用的字符序列 |
Throws:
Throw名稱 | Throw描述 |
---|---|
NullPointerException | 如果分隔符為空 |
public StringJoiner(CharSequence delimiter, CharSequence prefix, CharSequence suffix)
使用提供的前綴、分隔符和后綴的副本構造一個其中沒有字符的 StringJoiner。 如果沒有字符被添加到 StringJoiner 并且調用了訪問它的字符串值的方法,它將在結果中返回前綴 + 后綴(或其屬性),除非首先調用了 setEmptyValue。
參數(shù):
參數(shù)名稱 | 參數(shù)描述 |
---|---|
delimiter | 添加到 StringJoiner 的每個元素之間要使用的字符序列 |
prefix | 開頭使用的字符序列 |
suffix | 最后要使用的字符序列 |
Throws:
Throw名稱 | Throw描述 |
---|---|
NullPointerException | 如果前綴、分隔符或后綴為空 |
public StringJoiner setEmptyValue(CharSequence emptyValue)
設置在確定此 StringJoiner 的字符串表示且尚未添加任何元素(即為空時)時要使用的字符序列。 為此目的制作了一個emptyValue 參數(shù)的副本。 請注意,一旦調用了 add 方法,即使添加的元素對應于空字符串,StringJoiner 也不再被視為空。
參數(shù):
參數(shù)名稱 | 參數(shù)描述 |
---|---|
emptyValue | 作為空 StringJoiner 的值返回的字符 |
返回:
這個 StringJoiner 本身,所以調用可能會被鏈接
Throws:
Throw名稱 | Throw描述 |
---|---|
NullPointerException | 當 emptyValue 參數(shù)為 null |
public String toString()
返回當前值,由前綴、到目前為止添加的由分隔符分隔的值和后綴組成,除非沒有添加任何元素,在這種情況下,返回前綴 + 后綴或 emptyValue 字符
覆蓋:
類 Object 中的 toString
返回:
此 StringJoiner 的字符串表示形式
public StringJoiner add(CharSequence newElement)
添加給定 CharSequence 值的副本作為 StringJoiner 值的下一個元素。 如果 newElement 為 null,則添加“null”。
參數(shù):
參數(shù)名稱 | 參數(shù)描述 |
---|---|
newElement | 要添加的元素 |
返回:
對此 StringJoiner 的引用
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 為空 |
public int length()
返回此 StringJoiner 的字符串表示形式的長度。 請注意,如果未調用任何 add 方法,則將返回字符串表示的長度(前綴 + 后綴或空值)。 該值應等同于 toString().length()。
返回:
StringJoiner 的當前值的長度
Copyright©2021 w3cschool編程獅|閩ICP備15016281號-3|閩公網安備35020302033924號
違法和不良信息舉報電話:173-0602-2364|舉報郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號
聯(lián)系方式:
更多建議: