鴻蒙OS StringJoiner

StringJoiner

java.lang.Object

|---java.util.StringJoiner

public final class StringJoiner
extends Object

StringJoiner 用于構(gòu)造由分隔符分隔的字符序列，并且可以選擇以提供的前綴開(kāi)頭并以提供的后綴結(jié)尾。

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

構(gòu)造函數(shù)摘要

方法總結(jié)

構(gòu)造函數(shù)詳細(xì)信息

StringJoiner

public StringJoiner(CharSequence delimiter)

構(gòu)造一個(gè)其中沒(méi)有字符、沒(méi)有前綴或后綴的 StringJoiner，以及提供的分隔符的副本。 如果沒(méi)有字符被添加到 StringJoiner 并且調(diào)用訪問(wèn)它的值的方法，它將不會(huì)在結(jié)果中返回前綴或后綴（或其屬性），除非首先調(diào)用了 setEmptyValue。

參數(shù)：

Throws:

StringJoiner

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

使用提供的前綴、分隔符和后綴的副本構(gòu)造一個(gè)其中沒(méi)有字符的 StringJoiner。 如果沒(méi)有字符被添加到 StringJoiner 并且調(diào)用了訪問(wèn)它的字符串值的方法，它將在結(jié)果中返回前綴 + 后綴（或其屬性），除非首先調(diào)用了 setEmptyValue。

參數(shù)：

Throws:

方法詳情

setEmptyValue

public StringJoiner setEmptyValue(CharSequence emptyValue)

設(shè)置在確定此 StringJoiner 的字符串表示且尚未添加任何元素（即為空時(shí)）時(shí)要使用的字符序列。 為此目的制作了一個(gè)emptyValue 參數(shù)的副本。 請(qǐng)注意，一旦調(diào)用了 add 方法，即使添加的元素對(duì)應(yīng)于空字符串，StringJoiner 也不再被視為空。

參數(shù)：

返回:

這個(gè) StringJoiner 本身，所以調(diào)用可能會(huì)被鏈接

Throws:

toString

public String toString()

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

覆蓋：

類(lèi) Object 中的 toString

返回:

此 StringJoiner 的字符串表示形式

add

public StringJoiner add(CharSequence newElement)

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

參數(shù)：

返回:

對(duì)此 StringJoiner 的引用

merge

public StringJoiner merge(StringJoiner other)

如果給定的 StringJoiner 不為空，則添加不帶前綴和后綴的內(nèi)容作為下一個(gè)元素。 如果給定的 StringJoiner 為空，則調(diào)用無(wú)效。

如果從未調(diào)用過(guò) add()，并且從未使用非空 StringJoiner 參數(shù)調(diào)用過(guò) merge()，則 StringJoiner 為空。

如果另一個(gè) StringJoiner 使用不同的定界符，則來(lái)自另一個(gè) StringJoiner 的元素與該定界符連接，并將結(jié)果作為單個(gè)元素附加到此 StringJoiner。

參數(shù)：

返回:

這個(gè) StringJoiner

Throws:

length

public int length()

返回此 StringJoiner 的字符串表示形式的長(zhǎng)度。 請(qǐng)注意，如果未調(diào)用任何 add 方法，則將返回字符串表示的長(zhǎng)度（前綴 + 后綴或空值）。 該值應(yīng)等同于 toString().length()。

返回:

StringJoiner 的當(dāng)前值的長(zhǎng)度