Интерфейс Appendable

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

public interface Appendable

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

Добавляемые символы должны быть допустимыми символами Unicode, как описано в разделе Представление символов Unicode. Обратите внимание, что дополнительные символы могут состоять из нескольких 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, то добавляемая подпоследовательность определяется позицией и пределом буфера.

Содержимое этого Appendable не определено, если CharSequence изменяется во время вызова метода или при обращении к CharSequence выбрасывается исключение.

Параметры:: csq — последовательность символов для добавления. Если csq равно null, к этому Appendable добавляются четыре символа "null".
Возвращает:: Ссылка на этот 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, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/Appendable.html