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

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