Класс CharArrayWriter

java.lang.Object

java.io.Writer

java.io.CharArrayWriter

Все реализованные интерфейсы:: Closeable, Flushable, Appendable, AutoCloseable

public class CharArrayWriter extends Writer

Этот класс реализует буфер символов, который может быть использован в качестве объекта Writer. Буфер автоматически увеличивается при записи данных в поток. Данные могут быть получены с помощью методов toCharArray() и toString().

Примечание: Вызов close() для этого класса не имеет эффекта, и методы этого класса могут быть вызваны после закрытия потока без генерации исключения IOException.

С тех пор:: 1.1

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected char[]`	`buf`	Буфер, в котором хранятся данные.
`protected int`	`count`	Количество символов в буфере.

Поля, объявленные в классе java.io.Writer

lock

Краткое описание конструкторов

Конструктор	Описание
`CharArrayWriter()`	Создаёт новый объект CharArrayWriter.
`CharArrayWriter(int initialSize)`	Создаёт новый объект CharArrayWriter с заданным начальным размером.

Краткое описание методов

Модификатор и тип	Метод	Описание
`CharArrayWriter`	`append(char c)`	Добавляет указанный символ в этот объект Writer.
`CharArrayWriter`	`append(CharSequence csq)`	Добавляет указанную последовательность символов в этот объект Writer.
`CharArrayWriter`	`append(CharSequence csq, int start, int end)`	Добавляет подпоследовательность указанной последовательности символов в этот объект Writer.
`void`	`close()`	Закрывает поток.
`void`	`flush()`	Очищает поток.
`void`	`reset()`	Сбрасывает буфер, чтобы можно было использовать его повторно, без освобождения уже выделенного буфера.
`int`	`size()`	Возвращает текущий размер буфера.
`char[]`	`toCharArray()`	Возвращает копию входных данных.
`String`	`toString()`	Преобразует входные данные в строку.
`void`	`write(char[] c, int off, int len)`	Записывает символы в буфер.
`void`	`write(int c)`	Записывает символ в буфер.
`void`	`write(String str, int off, int len)`	Записывает часть строки в буфер.
`void`	`writeTo(Writer out)`	Записывает содержимое буфера в другой символьный поток.

Методы, объявленные в классе java.io.Writer

nullWriter, write, write

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание полей

buf

protected char[] buf

Буфер, в котором хранятся данные.

count

protected int count

Количество символов в буфере.

Подробное описание конструкторов

CharArrayWriter

public CharArrayWriter()

Создаёт новый CharArrayWriter.

CharArrayWriter

public CharArrayWriter(int initialSize)

Создаёт новый CharArrayWriter с указанным начальным размером.

Параметры:: initialSize - целое число, определяющее начальный размер буфера.
Исключения:: IllegalArgumentException - если initialSize отрицательный

Подробное описание методов

write

public void write(int c)

Записывает символ в буфер.

Переопределяет:: write в классе Writer
Параметры:: c - целое число, определяющее символ для записи

write

public void write(char[] c, int off, int len)

Записывает символы в буфер.

Определено в:: write в классе Writer
Параметры:: c - данные для записи; off - начальный смещение в данных; len - количество символов, которые записываются
Исключения:: IndexOutOfBoundsException - Если off отрицательный, или len отрицательный, или off + len отрицательный или больше длины данного массива

write

public void write(String str, int off, int len)

Записывает часть строки в буфер.

Переопределяет:: write в классе Writer
Параметры:: str - строка, из которой будут читаться символы для записи; off - смещение, с которого начинать чтение символов; len - количество символов для записи
Исключения:: IndexOutOfBoundsException - Если off отрицательный, или len отрицательный, или off + len отрицательный или больше длины заданной строки

writeTo

public void writeTo(Writer out) throws IOException

Записывает содержимое буфера в другой поток символов.

Параметры:: out - поток вывода для записи
Исключения:: IOException - Если возникает ошибка ввода-вывода.

append

public CharArrayWriter append(CharSequence csq)

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

Вызов этого метода в форме out.append(csq), когда csq не является null, ведёт себя точно так же, как вызов

    out.write(csq.toString())

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

Определено в:: append в интерфейсе Appendable
Переопределяет:: append в классе Writer
Параметры:: csq - Последовательность символов для добавления. Если csq является null, то четыре символа "null" будут добавлены в этот поток вывода.
Возвращает:: Этот поток вывода
С:: 1.5

append

public CharArrayWriter append(CharSequence csq, int start, int end)

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

Вызов этого метода в форме out.append(csq, start, end), когда csq не является null, ведёт себя точно так же, как вызов

    out.write(csq.subSequence(start, end).toString())

Определено в:: append в интерфейсе Appendable
Переопределяет:: append в классе Writer
Параметры:: csq - Последовательность символов, из которой будет добавлена подпоследовательность. Если csq является null, то символы будут добавлены как если бы csq содержал четыре символа "null".; start - Индекс первого символа в подпоследовательности; end - Индекс символа, следующего за последним символом в подпоследовательности
Возвращает:: Этот поток вывода
Исключения:: IndexOutOfBoundsException - Если start или end отрицательные, start больше end, или end больше csq.length()
С:: 1.5

append

public CharArrayWriter append(char c)

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

Вызов этого метода в форме out.append(c) ведёт себя точно так же, как вызов

    out.write(c)

Определено в:: append в интерфейсе Appendable
Переопределяет:: append в классе Writer
Параметры:: c - 16-битный символ для добавления
Возвращает:: Этот поток вывода
С:: 1.5

reset

public void reset()

Сбрасывает буфер, чтобы вы могли использовать его снова, не удаляя уже выделенный буфер.

toCharArray

public char[] toCharArray()

Возвращает копию входных данных.

Возвращает:: массив символов, скопированных из входных данных.

size

public int size()

Возвращает текущий размер буфера.

Возвращает:: целое число, представляющее текущий размер буфера.

toString

public String toString()

Преобразует входные данные в строку.

Переопределяет:: toString в классе Object
Возвращает:: строку.

flush

public void flush()

Очистить поток.

Метод flush класса CharArrayWriter ничего не делает.

Определено в:: flush в интерфейсе Flushable
Определено в:: flush в классе Writer

close

public void close()

Закрыть поток. Этот метод не освобождает буфер, так как его содержимое может быть всё ещё необходимо. Примечание: вызов этого метода в этом классе не окажет никакого влияния.

Определено в:: close в интерфейсе AutoCloseable
Определено в:: close в интерфейсе Closeable
Определено в:: close в классе Writer

© 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/io/CharArrayWriter.html