Интерфейс 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, 2023, 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/21/docs/api/java.base/java/lang/Appendable.html