public final class StringJoiner
extends Object
java.lang.Object | |
↳ | java.util.StringJoiner |
StringJoiner
用于构造由分隔符分隔的字符序列,并且可以从提供的前缀开始并以提供的后缀结尾。
在向StringJoiner
添加内容之前,默认情况下,其sj.toString()
方法将返回prefix + suffix
。 但是,如果调用setEmptyValue
方法,则将返回提供的emptyValue
。 这可用于,例如,使用一组表示法来表示空集,即创建字符串时"{}"
,其中prefix
是"{"
时, suffix
是"}"
和什么也没有添加到StringJoiner
。
Public constructors |
|
---|---|
StringJoiner(CharSequence delimiter) 构造一个 |
|
StringJoiner(CharSequence delimiter, CharSequence prefix, CharSequence suffix) 构造一个 |
Public methods |
|
---|---|
StringJoiner |
add(CharSequence newElement) 将给定的副本 |
int |
length() 返回此 |
StringJoiner |
merge(StringJoiner other)
|
StringJoiner |
setEmptyValue(CharSequence emptyValue) 设置确定此 |
String |
toString() 返回当前值,包含 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
StringJoiner (CharSequence delimiter)
构造一个StringJoiner
与其中不带字符,没有prefix
或suffix
,和所提供的副本delimiter
。 如果没有字符被添加到StringJoiner
并且访问其值的方法被调用,那么除非setEmptyValue
第一次被调用,否则它不会返回结果中的prefix
或suffix
(或其属性)。
Parameters | |
---|---|
delimiter |
CharSequence : the sequence of characters to be used between each element added to the StringJoiner value |
Throws | |
---|---|
NullPointerException |
if delimiter is null |
StringJoiner (CharSequence delimiter, CharSequence prefix, CharSequence suffix)
构造一个StringJoiner
使用的供给拷贝在不带字符prefix
, delimiter
和suffix
。 如果没有字符被添加到StringJoiner
并且访问其字符串值的方法被调用,它将返回结果中的prefix + suffix
(或其属性),除非首先调用setEmptyValue
。
Parameters | |
---|---|
delimiter |
CharSequence : the sequence of characters to be used between each element added to the StringJoiner |
prefix |
CharSequence : the sequence of characters to be used at the beginning |
suffix |
CharSequence : the sequence of characters to be used at the end |
Throws | |
---|---|
NullPointerException |
if prefix , delimiter , or suffix is null |
StringJoiner add (CharSequence newElement)
将给定的副本CharSequence
值作为下一个元素StringJoiner
值。 如果newElement
是null
,则添加"null"
。
Parameters | |
---|---|
newElement |
CharSequence : The element to add |
Returns | |
---|---|
StringJoiner |
a reference to this StringJoiner |
int length ()
返回此StringJoiner
的String
表示的StringJoiner
。 请注意,如果未调用添加方法,则将返回String
表示( prefix + suffix
或emptyValue
)的长度。 该值应该等于toString().length()
。
Returns | |
---|---|
int |
the length of the current value of StringJoiner |
StringJoiner merge (StringJoiner other)
StringJoiner
不是前缀和后缀,则将给定StringJoiner
的内容添加为下一个元素。 如果给定的StringJoiner
为空,则该呼叫不起作用。
一个 StringJoiner
是空的,如果 add()
从未被调用,如果 merge()
从未调用一个非空 StringJoiner
的说法。
如果另一个 StringJoiner
正在使用不同的分隔符,则来自其他 StringJoiner
元素与该分隔符连接,并且结果作为单个元素附加到此 StringJoiner
。
Parameters | |
---|---|
other |
StringJoiner : The StringJoiner whose contents should be merged into this one |
Returns | |
---|---|
StringJoiner |
This StringJoiner |
Throws | |
---|---|
NullPointerException |
if the other StringJoiner is null |
StringJoiner setEmptyValue (CharSequence emptyValue)
设置在确定此StringJoiner
的字符串表示形式时要使用的字符序列,并且尚未添加任何元素,即,该元素为空时。 emptyValue
参数的副本就是为此目的而制作的。 需要注意的是,一旦一个附加方法被调用时, StringJoiner
不再被认为是空的,即使元素(一个或多个)添加对应于空String
。
Parameters | |
---|---|
emptyValue |
CharSequence : the characters to return as the value of an empty StringJoiner |
Returns | |
---|---|
StringJoiner |
this StringJoiner itself so the calls may be chained |
Throws | |
---|---|
NullPointerException |
when the emptyValue parameter is null |
String toString ()
返回当前值,包含 prefix
,到目前为止由 delimiter
分隔的值和 suffix
,除非在这种情况下未添加任何元素,则返回 prefix + suffix
或 emptyValue
字符
Returns | |
---|---|
String |
the string representation of this StringJoiner |