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 |
|
|---|---|
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 |