Класс CharArrayWriter

java.lang.Object

java.io.Writer

java.io.CharArrayWriter

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

public class CharArrayWriter extends Writer

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

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

Начиная с:: 1.1

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

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

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

lock

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

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

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

Модификатор и тип	Метод	Описание
`CharArrayWriter`	`append(char c)`	Добавляет указанный символ в этот поток записи.
`CharArrayWriter`	`append(CharSequence csq)`	Добавляет указанную последовательность символов в этот поток записи.
`CharArrayWriter`	`append(CharSequence csq, int start, int end)`	Добавляет подпоследовательность указанной последовательности символов в этот поток записи.
`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)`	Записывает содержимое буфера в другой символьный поток.

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

nullWriter, write, write

Методы, объявленные в классе 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/io/CharArrayWriter.html