compact1, compact2, compact3

java.util

Class StringJoiner

java.lang.Object

java.util.StringJoiner

public final class StringJoiner
extends Object

StringJoiner是用来构建一个字符序列由一个分隔符分隔，可以从一个提供前缀和结束与提供的后缀。

添加的东西的StringJoiner之前，其sj.toString()方法，默认情况下，返回prefix + suffix。然而，如果setEmptyValue方法被调用时，将返回的emptyValue提供代替。这可以使用，例如，创建一个字符串使用符号来表示一个空集，即"{}"时，那里的prefix是"{"，suffix是"}"的并没有被添加到StringJoiner。

API Note:

字符串"[George:Sally:Fred]"可以构造如下：

 StringJoiner sj = new StringJoiner(":", "[", "]");
 sj.add("George").add("Sally").add("Fred");
 String desiredString = sj.toString();
 

一个StringJoiner可以用来创建格式化的输出从一个Stream使用Collectors.joining(CharSequence)。例如：

 List<Integer> numbers = Arrays.asList(1, 2, 3, 4);
 String commaSeparatedNumbers = numbers.stream()
     .map(i -> i.toString())
     .collect(Collectors.joining(", "));
 

从以下版本开始：

一点八

另请参见：

Collectors.joining(CharSequence)， Collectors.joining(CharSequence, CharSequence, CharSequence)

构造方法摘要

构造方法

Constructor and Description
StringJoiner(CharSequence delimiter) 构建了一个不字 StringJoiner，没有 prefix或 suffix，和一份提供的 delimiter。
StringJoiner(CharSequence delimiter, CharSequence prefix, CharSequence suffix) 构建了一个在使用所提供的 prefix副本没有字符 StringJoiner， delimiter和 suffix。

方法摘要

Modifier and Type	Method and Description
StringJoiner	add(CharSequence newElement) 增加了一份给 CharSequence值的 StringJoiner价值的下一个元素。
int	length() 返回该 StringJoiner的 String表示长度。
StringJoiner	merge(StringJoiner other) 在给定的 StringJoiner没有前缀和后缀的内容作为下一个元素如果是非空。
StringJoiner	setEmptyValue(CharSequence emptyValue) 机组可用于确定本 StringJoiner字符串表示没有元素时，字符序列已被添加，即，当它是空的。
String	toString() 返回当前值，组成的 prefix的附加价值，到目前为止 delimiter分离，和 suffix，除非没有元素已经在这种情况下，增加的 prefix + suffix或 emptyValue字符返回

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

StringJoiner

public StringJoiner(CharSequence delimiter)

构建了一个不字 StringJoiner，没有 prefix或 suffix，和一份提供的 delimiter。如果没有字符被添加到 StringJoiner方法访问它的值被调用时，它不会返回一个 prefix或 suffix（或性质）的结果，除非 setEmptyValue首先被称为。

参数

delimiter -字符是用元素之间的顺序添加到 StringJoiner价值

异常

如果是 null delimiter NullPointerException

StringJoiner

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

构建了一个在使用所提供的 prefix副本没有字符 StringJoiner， delimiter和 suffix。如果没有字符被添加到 StringJoiner方法访问它的字符串值被调用时，它将返回 prefix + suffix（或性质）的结果，除非 setEmptyValue首先被称为。

参数

delimiter -字符是用元素之间的顺序添加到 StringJoiner

prefix -字符用于开始的序列

suffix -字符被用作最后的序列

异常

NullPointerException -如果 prefix， delimiter，或 suffix是 null

方法详细信息

setEmptyValue

public StringJoiner setEmptyValue(CharSequence emptyValue)

机组可用于确定本 StringJoiner字符串表示没有元素时，字符序列已被添加，即，当它是空的。一个副本的 emptyValue参数是为这个目的。值得注意的是，一旦添加方法被调用时，该 StringJoiner不再被认为是空的，即使元（S）添加对应的空 String。

参数

emptyValue -人物返回一个空值 StringJoiner

结果

这 StringJoiner本身，所以电话可以连接

异常

NullPointerException -当 emptyValue参数 null

toString

public String toString()

返回当前值，组成的 prefix的附加价值，到目前为止 delimiter分离，和 suffix，除非没有元素已经在这种情况下，增加的 prefix + suffix或 emptyValue字符返回

重写：

toString 方法重写，继承类 Object

结果

这 StringJoiner的字符串表示形式

add

public StringJoiner add(CharSequence newElement)

增加了一份给 CharSequence值的 StringJoiner价值的下一个元素。如果 newElement是 null，然后 "null"添加。

参数

newElement -元素添加

结果

一提到这个 StringJoiner

merge

public StringJoiner merge(StringJoiner other)

在给定的 StringJoiner没有前缀和后缀的内容作为下一个元素如果是非空。如果给定的 StringJoiner是空的，电话没有影响。

如果add()从未被称为StringJoiner是空的，如果merge()从未被称为一个非空的StringJoiner论点。

如果其他StringJoiner使用不同的分隔符，然后从其他StringJoiner元素，分隔符和结果链接被添加到这StringJoiner作为一个单一的元素。

参数

other的内容应该被合并到这一个 StringJoiner

结果

这 StringJoiner

异常

NullPointerException -如果其他 StringJoiner是空的

length

public int length()

返回该 StringJoiner的 String表示长度。请注意，如果没有添加方法被称为，当时的 String表示长度（或 prefix + suffix或 emptyValue）将返回。价值应相当于 toString().length()。

结果

对 StringJoiner当前值的长度