Класс StringWriter

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

Закрытие StringWriter не имеет эффекта. Методы в этом классе могут вызываться после закрытия потока без генерации IOException.

Конструкторы

StringWriter

public StringWriter()

Создать новый объект StringWriter с использованием размера буфера строк по умолчанию.

StringWriter

public StringWriter(int initialSize)

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

Параметры:

initialSize - Количество char значений, которые поместятся в этот буфер перед его автоматическим расширением

Исключения:

IllegalArgumentException - Если initialSize отрицательно

Методы

write

public void write(int c)

Записать один символ.

Переопределяет:

write в классе Writer

Параметры:

c - int, определяющий символ, который необходимо записать

write

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

Записать часть массива символов.

Задано:

write в классе Writer

Параметры:

cbuf - Массив символов

off - Смещение, с которого начать запись символов

len - Количество символов для записи

write

public void write(String str)

Записать строку.

Переопределяет:

write в классе Writer

Параметры:

str - Строка для записи

write

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

Записать часть строки.

Переопределяет:

write в классе Writer

Параметры:

str - Строка для записи

off - Смещение, с которого начать запись символов

len - Количество символов для записи

append

public StringWriter append(CharSequence csq)

out.write(csq.toString())

Задано:

append в интерфейсе Appendable

Переопределяет:

append в классе Writer

Параметры:

csq - Последовательность символов для добавления. Если csq равно null, тогда четыре символа "null" добавляются в этот объект Writer.

Возвращает:

Этот объект Writer

С момента:

1.5

append

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

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

Задано:

append в интерфейсе Appendable

Переопределяет:

append в классе Writer

Параметры:

csq - Последовательность символов, из которой будет добавлена подпоследовательность. Если csq равно null, символы будут добавлены так, как если бы csq содержал четыре символа "null".

start - Индекс первого символа в подпоследовательности

end - Индекс символа, следующего за последним символом в подпоследовательности

Возвращает:

Этот объект Writer

Исключения:

IndexOutOfBoundsException - Если start или end отрицательны, start больше end, или end больше csq.length()

С момента:

1.5

append

public StringWriter append(char c)

out.write(c)

Задано:

append в интерфейсе Appendable

Переопределяет:

append в классе Writer

Параметры:

c - 16-битный символ для добавления

Возвращает:

Этот объект Writer

С момента:

1.5

toString

public String toString()

Возвращает текущее значение буфера в виде строки.

Переопределяет:

toString в классе Object

Возвращает:

строковое представление объекта.

getBuffer

public StringBuffer getBuffer()

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

Возвращает:

StringBuffer, содержащий текущее значение буфера.

flush

public void flush()

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

Задано:

flush в интерфейсе Flushable

Задано:

flush в классе Writer

close

public void close()
           throws IOException

Закрытие StringWriter не имеет эффекта. Методы в этом классе могут вызываться после закрытия потока без генерации IOException.

Задано:

close в интерфейсе Closeable

Задано:

close в интерфейсе AutoCloseable

Задано:

close в классе Writer

Исключения:

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