Интерфейс 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

Appendable append(CharSequence csq)
           throws IOException

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

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

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

append

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

Appendable append(char c)
           throws IOException

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

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

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.