Класс BufferedWriter

public class BufferedWriter
extends Writer

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

Размер буфера можно указать или принять значение по умолчанию. Значение по умолчанию достаточно для большинства случаев.

Предоставлен метод newLine(), который использует собственную концепцию разделителя строк платформы, определённую системной переменной line.separator. Не все платформы используют символ новой строки ('\n') для завершения строк. Поэтому предпочтительнее вызывать этот метод для завершения каждой строки вывода, чем писать символ новой строки напрямую.

В общем случае Writer сразу отправляет свой вывод в базовый поток символов или байтов. Если не требуется моментальный вывод, рекомендуется обернуть BufferedWriter вокруг любого Writer, чьи операции write() могут быть дорогостоящими, такие как FileWriters и OutputStreamWriters. Например,

PrintWriter out
   = new PrintWriter(new BufferedWriter(new FileWriter("foo.out")));

буферизует вывод PrintWriter в файл. Без буферизации каждый вызов метода print() приводил бы к преобразованию символов в байты, которые затем сразу записывались бы в файл, что может быть очень неэффективно.

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

BufferedWriter

public BufferedWriter(Writer out)

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

Параметры:

out - Writer

BufferedWriter

public BufferedWriter(Writer out,
                      int sz)

Создаёт новый буферизованный поток символьного вывода, использующий буфер вывода заданного размера.

Параметры:

out - Writer

sz - Размер буфера вывода, положительное целое число

Исключения:

IllegalArgumentException - Если sz <= 0

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

write

public void write(int c)
           throws IOException

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

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

write в классе Writer

Параметры:

c - целое число, задающее символ для записи

Исключения:

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

write

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

Определено:

write в классе Writer

Параметры:

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

off - Смещение для начала чтения символов

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

Исключения:

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

write

public void write(String s,
                  int off,
                  int len)
           throws IOException

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

write в классе Writer

Параметры:

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

off - Смещение для начала чтения символов

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

Исключения:

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

newLine

public void newLine()
             throws IOException

Записывает разделитель строк. Строка разделителя строк определяется системной переменной line.separator, и не обязательно является одиночным символом новой строки ('\n').

Исключения:

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

flush

public void flush()
           throws IOException

Сбрасывает поток.

Определено:

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

Определено:

flush в классе Writer

Исключения:

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

close

public void close()
           throws IOException

Описание скопировано из класса: Writer

Закрывает поток, предварительно его сбросив. После закрытия потока дальнейшие вызовы write() или flush() приведут к броску исключения IOException. Закрытие уже закрытого потока не оказывает никакого влияния.

Определено:

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

Определено:

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

Определено:

close в классе Writer

Исключения:

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