Интерфейс Appendable

Все известные реализующие классы:: BufferedWriter, CharArrayWriter, CharBuffer, FileWriter, FilterWriter, LogStream, OutputStreamWriter, PipedWriter, PrintStream, PrintWriter, StringBuffer, StringBuilder, StringWriter, Writer

public interface Appendable

Объект, к которому можно добавить последовательности и значения. Интерфейс должен быть реализован любым классом, экземпляры которого предназначены для получения отформатированного вывода из Formatter.

Присоединяемые символы должны быть допустимыми символами Юникода, как описано в Представлении символов Юникода. Обратите внимание, что дополнительные символы могут состоять из нескольких 16-битных char значений.

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

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

С тех пор:: 1.5

Методы

Модификатор и тип	Метод	Описание
`Appendable`	`append(char c)`	Добавляет указанный символ к этому `Appendable`.
`Appendable`	`append(CharSequence csq)`	Добавляет указанную последовательность символов к этому `Appendable`.
`Appendable`	`append(CharSequence csq, int start, int end)`	Добавляет подпоследовательность указанной последовательности символов к этому `Appendable`.

Методы

append(java.lang.CharSequence)

Appendable append(CharSequence csq)
           throws IOException

Добавляет указанную последовательность символов к этому Appendable.

В зависимости от того, какой класс реализует последовательность символов csq, вся последовательность может быть не добавлена. Например, если csq является CharBuffer, то подпоследовательность для добавления определяется положением и пределом буфера.

Параметры:: csq - Последовательность символов для добавления. Если csq является null, то к этому Appendable добавляются четыре символа "null".
Возвращает:: Ссылка на этот Appendable
Исключение:: IOException - Если произошла ошибка ввода-вывода

append(java.lang.CharSequence,int,int)

Appendable append(CharSequence csq,
                  int start,
                  int end)
           throws IOException

Добавляет подпоследовательность указанной последовательности символов к этому Appendable.

Вызов этого метода в форме out.append(csq, start, end) когда csq не null, ведет себя точно так же, как вызов

out.append(csq.subSequence(start, end))

Параметры:: csq - Последовательность символов, из которой будет добавлена подпоследовательность. Если csq является null, символы будут добавлены так, как если бы csq содержали четыре символа "null".; start - Индекс первого символа в подпоследовательности; end - Индекс символа, следующего за последним символом в подпоследовательности
Возвращает:: Ссылка на этот Appendable
Исключение:: IndexOutOfBoundsException - Если start или end отрицательные, start больше end, или end больше csq.length(); IOException - Если произошла ошибка ввода-вывода

append(char)

Appendable append(char c)
           throws IOException

Добавляет указанный символ к этому Appendable.

Параметры:: c - Символ для добавления
Возвращает:: Ссылка на этот Appendable
Исключение:: IOException - Если произошла ошибка ввода-вывода