Интерфейс Appendable

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

public interface Appendable

Объект, к которому можно добавить последовательности и значения. Интерфейс 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, то подпоследовательность для добавления определяется положением и пределом буфера.

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

Параметры:: 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, 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/lang/Appendable.html