compact1, compact2, compact3

java.util

Класс StringJoiner

java.lang. Объект

java.util. StringJoiner

public final class StringJoiner
extends Object

StringJoiner используется, чтобы создать последовательность символов, разделенных разделителем и дополнительно запускающийся с предоставленного префикса и заканчивающийся предоставленным суффиксом.

Например, Строка "[George:Sally:Fred]" может быть создан следующим образом:

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

До добавления чего-то к StringJoiner, sj.toString() метод, по умолчанию, возвратится prefix + suffix. Однако, если setEmptyValue метод вызывают, emptyValue предоставленный будет возвращен вместо этого. Это может использоваться, например, создавая строку, используя нотацию набора, чтобы указать на пустое множество, то есть. "{}", где prefix "{", suffix "}" и ничто не было добавлено к StringJoiner.

A StringJoiner может использоваться, чтобы создать отформатированный вывод из набора, используя лямбда-выражения как показано в следующем примере.

 
     List<Person> people = ...
     String commaSeparatedNames =
         people.map(p -> p.getName()).into(new StringJoiner(", ")).toString();
 

С тех пор:

1.8

Сводка конструктора

Конструкторы

Конструктор и Описание
StringJoiner(CharSequence delimiter) Конструкции a StringJoiner без символов в этом, без prefix или suffix, и копия предоставленного delimiter.
StringJoiner(CharSequence delimiter, CharSequence prefix, CharSequence suffix) Конструкции a StringJoiner без символов в этом использующий копии предоставленного prefix, delimiter и suffix.

Сводка метода

Модификатор и Тип	Метод и Описание
StringJoiner	add(CharSequence newElement) Добавьте копию предоставленного CharSequence оцените как следующий элемент StringJoiner значение.
int	length() Длина StringJoiner значение, то есть.
StringJoiner	setEmptyValue(CharSequence emptyValue) Устанавливает последовательность символов, которые будут использоваться, определяя строковое представление этого StringJoiner и никакие элементы еще не были добавлены, то есть.
Строка	toString() Возвращает текущую стоимость, состоя из prefix, значения, добавляемые до сих пор разделяемый delimiter, и suffix, если никакие элементы не были добавлены когда, prefix + suffix или emptyValue символы возвращаются

Методы, наследованные от class java.lang. Объект

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

Деталь конструктора

StringJoiner

public StringJoiner(CharSequence delimiter)

Конструкции a StringJoiner без символов в этом, без prefix или suffix, и копия предоставленного delimiter. Если никакие символы не добавляются к StringJoiner и методы, получающие доступ к значению этого, вызываются, это не будет возвращать a prefix или suffix (или свойства этого) в результате, если setEmptyValue был сначала вызван.

Параметры:

delimiter - последовательность символов, которые будут использоваться между каждым элементом, добавленным к StringJoiner значение

Броски:

NullPointerException - если delimiter null

StringJoiner

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

Конструкции a StringJoiner без символов в этом использующий копии предоставленного prefix, delimiter и suffix. Если никакие символы не добавляются к StringJoiner и методы, получающие доступ к строковому значению этого, вызываются, это возвратится prefix + suffix (или свойства этого) в результате, если setEmptyValue был сначала вызван.

Параметры:

delimiter - последовательность символов, которые будут использоваться между каждым элементом, добавленным к StringJoiner

prefix - последовательность символов, которые будут использоваться вначале

suffix - последовательность символов, которые будут использоваться в конце

Броски:

NullPointerException - если prefix, delimiter, или suffix null

Деталь метода

setEmptyValue

public StringJoiner setEmptyValue(CharSequence emptyValue)

Устанавливает последовательность символов, которые будут использоваться, определяя строковое представление этого StringJoiner и никакие элементы еще не были добавлены, то есть когда это пусто. Копия emptyValue параметр делается с этой целью. Отметьте, что однажды добавить метод был вызван, StringJoiner больше не считается пустым, даже если добавленный элемент (ы) соответствует пустому String.

Параметры:

emptyValue - символы, чтобы возвратиться как значение пустого StringJoiner

Возвраты:

это StringJoiner непосредственно, таким образом, вызовы могут быть объединены в цепочку

Броски:

NullPointerException - когда emptyValue параметр null

toString

public String toString()

Возвращает текущую стоимость, состоя из prefix, значения, добавляемые до сих пор разделяемый delimiter, и suffix, если никакие элементы не были добавлены когда, prefix + suffix или emptyValue символы возвращаются

Переопределения:

toString в class Object

Возвраты:

строковое представление этого StringJoiner

добавить

public StringJoiner add(CharSequence newElement)

Добавьте копию предоставленного CharSequence оцените как следующий элемент StringJoiner значение. Если newElement null, тогда "null" добавляется.

Параметры:

newElement - Элемент, чтобы добавить

Возвраты:

ссылка на это StringJoiner

длина

public int length()

Длина StringJoiner значение, то есть длина String представление StringJoiner. Отметьте, что, если не добавляют, методы вызвали, то длина String представление (также prefix + suffix или emptyValue) будет возвращен. Значение должно быть эквивалентным toString().length().

Возвраты:

длина текущей стоимости StringJoiner