java.lang

Интерфейсный Appendable

Все Известные Классы с реализацией:

BufferedWriter, CharArrayWriter, CharBuffer, FileWriter, FilterWriter, LogStream, OutputStreamWriter, PipedWriter, PrintStream, PrintWriter, StringBuffer, StringBuilder, StringWriter, Писатель

public interface Appendable

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

Символы, которые будут добавлены, должны быть допустимыми символами Unicode как описано в Представлении Символа Unicode. Отметьте, что дополнительные символы могут быть составлены из многократных 16-разрядных значений char.

Appendables не обязательно безопасны для многопоточного доступа. Потокобезопасность является ответственностью классов, которые расширяют и реализуют этот интерфейс.

Так как этот интерфейс может быть реализован существующими классами с различными стилями обработки ошибок нет никакой гарантии, что ошибки будут распространены к invoker.

С тех пор:

1.5

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
Appendable	append(char c) Добавляет указанный символ к этому Appendable.
Appendable	append(CharSequence csq) Добавляет указанную символьную последовательность к этому Appendable.
Appendable	append(CharSequence csq, int start, int end) Добавляет подпоследовательность указанной символьной последовательности к этому Appendable.

Деталь метода

добавить

Appendable append(CharSequence csq)
                  throws IOException

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

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

Параметры:

csq - Символьная последовательность, чтобы добавить. Если csq является null, то эти четыре символа "null" добавляются к этому Appendable.

Возвраты:

Ссылка на этот Appendable

Броски:

IOException - Если ошибка ввода-вывода происходит

добавить

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 - Если ошибка ввода-вывода происходит

добавить

Appendable append(char c)
                  throws IOException

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

Параметры:

c - Символ, чтобы добавить

Возвраты:

Ссылка на этот Appendable

Броски:

IOException - Если ошибка ввода-вывода происходит