java.io

Класс BufferedWriter

java.lang. Объект

java.io. Писатель

java.io. BufferedWriter

Все Реализованные Интерфейсы:

Closeable, Flushable, Appendable, AutoCloseable

public class BufferedWriter
extends Writer

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

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

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

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

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

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

С тех пор:

JDK1.1

См. Также:

PrintWriter, FileWriter, OutputStreamWriter, Files.newBufferedWriter(java.nio.file.Path, java.nio.charset.Charset, java.nio.file.OpenOption...)

Полевая Сводка

Поля java.io унаследованный от класса. Писатель

блокировка

Сводка конструктора

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

Конструктор и Описание
BufferedWriter(Writer out) Создает буферизованный поток вывода символов, который использует буфер вывода размера по умолчанию.
BufferedWriter(Writer out, int sz) Создает новый буферизованный поток вывода символов, который использует буфер вывода данного размера.

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

Методы

Модификатор и Тип	Метод и Описание
void	close() Закрывает поток, сбрасывая это сначала.
void	flush() Сбрасывает поток.
void	newLine() Пишет разделитель строки.
void	write(char[] cbuf, int off, int len) Пишет часть массива символов.
void	write(int c) Пишет единственный символ.
void	write(String s, int off, int len) Пишет часть Строки.

Методы java.io унаследованный от класса. Писатель

append, append, append, write, write

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

BufferedWriter

public BufferedWriter(Writer out)

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

Параметры:

out - Писатель

BufferedWriter

public BufferedWriter(Writer out,
              int sz)

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

Параметры:

out - Писатель

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

Броски:

IllegalArgumentException - Если sz <= 0

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

записать

public void write(int c)
           throws IOException

Пишет единственный символ.

Переопределения:

write в классе Writer

Параметры:

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

Броски:

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

записать

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

Пишет часть массива символов.

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

Определенный:

write в классе Writer

Параметры:

cbuf - Символьный массив

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

len - Число символов, чтобы записать

Броски:

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

записать

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

Пишет часть Строки.

Если значение параметра len отрицательно тогда, никакие символы не пишутся. Это противоречит спецификации этого метода в суперклассе, который требует что IndexOutOfBoundsException быть брошенным.

Переопределения:

write в классе Writer

Параметры:

s - Строка, которая будет записана

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

len - Число символов, которые будут записаны

Броски:

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

новая строка

public void newLine()
             throws IOException

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

Броски:

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

сброс

public void flush()
           throws IOException

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

Определенный:

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

Определенный:

flush в классе Writer

Броски:

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

близко

public void close()
           throws IOException

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

Закрывает поток, сбрасывая это сначала. Как только поток был закрыт, далее запишите () или сброс (), вызовы заставят IOException быть брошенным. Закрытие ранее закрытого потока не имеет никакого эффекта.

Определенный:

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

Определенный:

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

Определенный:

close в классе Writer

Броски:

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