Most visited

Recently visited

Added in API level 24

StringJoiner

public final class StringJoiner
extends Object

java.lang.Object
   ↳ java.util.StringJoiner


StringJoiner用于构造由分隔符分隔的字符序列,并且可以从提供的前缀开始并以提供的后缀结尾。

在向StringJoiner添加内容之前,默认情况下,其sj.toString()方法将返回prefix + suffix 但是,如果调用setEmptyValue方法,则将返回提供的emptyValue 这可用于,例如,使用一组表示法来表示空集,即创建字符串时"{}" ,其中prefix"{"时, suffix"}"和什么也没有添加到StringJoiner

也可以看看:

Summary

Public constructors

StringJoiner(CharSequence delimiter)

构造一个 StringJoiner与其中不带字符,没有 prefixsuffix ,和所提供的副本 delimiter

StringJoiner(CharSequence delimiter, CharSequence prefix, CharSequence suffix)

构造一个 StringJoiner使用的供给拷贝在不带字符 prefixdelimitersuffix

Public methods

StringJoiner add(CharSequence newElement)

将给定的副本 CharSequence值作为下一个元素 StringJoiner值。

int length()

返回此 StringJoinerString表示的 StringJoiner

StringJoiner merge(StringJoiner other)

StringJoiner不是前缀和后缀,则将给定 StringJoiner的内容添加为下一个元素。

StringJoiner setEmptyValue(CharSequence emptyValue)

设置确定此 StringJoiner的字符串表示形式时要使用的字符序列,并且尚未添加任何元素(即空白时)。

String toString()

返回当前值,包含 prefix ,到目前为止由 delimiter分隔的值和 suffix ,除非在这种情况下未添加元素,则返回 prefix + suffixemptyValue字符

Inherited methods

From class java.lang.Object

Public constructors

StringJoiner

Added in API level 24
StringJoiner (CharSequence delimiter)

构造一个StringJoiner与其中不带字符,没有prefixsuffix ,和所提供的副本delimiter 如果没有字符被添加到StringJoiner并且访问其值的方法被调用,那么除非setEmptyValue第一次被调用,否则它不会返回结果中的prefixsuffix (或其属性)。

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

Added in API level 24
StringJoiner (CharSequence delimiter, 
                CharSequence prefix, 
                CharSequence suffix)

构造一个StringJoiner使用的供给拷贝在不带字符prefixdelimitersuffix 如果没有字符被添加到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

Public methods

add

Added in API level 24
StringJoiner add (CharSequence newElement)

将给定的副本CharSequence值作为下一个元素StringJoiner值。 如果newElementnull ,则添加"null"

Parameters
newElement CharSequence: The element to add
Returns
StringJoiner a reference to this StringJoiner

length

Added in API level 24
int length ()

返回此StringJoinerString表示的StringJoiner 请注意,如果未调用添加方法,则将返回String表示( prefix + suffixemptyValue )的长度。 该值应该等于toString().length()

Returns
int the length of the current value of StringJoiner

merge

Added in API level 24
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

setEmptyValue

Added in API level 24
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

toString

Added in API level 24
String toString ()

返回当前值,包含 prefix ,到目前为止由 delimiter分隔的值和 suffix ,除非在这种情况下未添加任何元素,则返回 prefix + suffixemptyValue字符

Returns
String the string representation of this StringJoiner

Hooray!