compact1, compact2, compact3

java.io

Class BufferedWriter

java.lang.Object

java.io.Writer

java.io.BufferedWriter

All Implemented Interfaces:

Closeable ， Flushable ， Appendable ， AutoCloseable

public class BufferedWriter
extends Writer

将文本写入字符输出流，缓冲字符，以提供单个字符，数组和字符串的高效写入。

可以指定缓冲区大小，或者可以接受默认大小。 默认值足够大，可用于大多数用途。

提供了一个newLine（）方法，它使用平台自己的系统属性line.separator定义的行分隔符概念。 并非所有平台都使用换行符（'\ n'）来终止行。 因此，调用此方法来终止每个输出行，因此优选直接写入换行符。

一般来说，Writer将其输出立即发送到底层字符或字节流。 除非需要提示输出，否则建议将BufferedWriter包装在其write（）操作可能很昂贵的Writer上，例如FileWriters和OutputStreamWriters。 例如，

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

将缓冲PrintWriter的输出到文件。 没有缓冲，每次调用print（）方法都会使字符转换为字节，然后立即写入文件，这可能非常低效。

从以下版本开始：

JDK1.1

另请参见：

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

Field Summary

Fields inherited from class java.io.Writer

lock

构造方法摘要

构造方法

Constructor and Description
BufferedWriter(Writer out) 创建使用默认大小的输出缓冲区的缓冲字符输出流。
BufferedWriter(Writer out, int sz) 创建一个新的缓冲字符输出流，使用给定大小的输出缓冲区。

方法摘要

Modifier and Type	Method and Description
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) 写一个字符串的一部分。

Methods inherited from class java.io.Writer

append, append, append, write, write

Methods inherited from class java.lang.Object

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

方法详细信息

write

public void write(int c)
           throws IOException

写一个字符

重写：

write在 Writer

参数

c - int指定要写入的字符

异常

IOException - 如果发生I / O错误

write

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

写入字符数组的一部分。

通常，此方法将给定数组中的字符存储到此流的缓冲区中，根据需要将缓冲区刷新到底层流。 然而，如果请求的长度至少与缓冲区一样大，那么这个方法将刷新缓冲区，并将字符直接写入底层流。 因此冗余BufferedWriter将不会不必要地复制数据。

Specified by:

write在 Writer

参数

cbuf - 一个字符数组

off - 开始读取字符的偏移量

len - 要写入的 len数

异常

IOException - 如果发生I / O错误

write

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

写一个字符串的一部分。

如果len参数的值为负，则不会写入任何字符。 这与superclass中的这种方法的规范相反 ， superclass要求抛出一个IndexOutOfBoundsException 。

重写：

write在 Writer

参数

s - 要写入的字符串

off - 开始读取字符的偏移量

len - 要写入的字符数

异常

IOException - 如果发生I / O错误

newLine

public void newLine()
             throws IOException

写一行行分隔符。 行分隔符字符串由系统属性line.separator定义，并不一定是单个换行符（'\ n'）字符。

异常

IOException - 如果发生I / O错误

flush

public void flush()
           throws IOException

刷新流。

Specified by:

flush在界面 Flushable

Specified by:

flush在 Writer

异常

IOException - 如果发生I / O错误

close

public void close()
           throws IOException

描述从类别： Writer复制

关闭流，先刷新。 一旦流已关闭，进一步的write（）或flush（）调用将导致抛出IOException。 关闭以前关闭的流无效。

Specified by:

close在界面 Closeable

Specified by:

close在界面 AutoCloseable

Specified by:

close在 Writer

异常

IOException - 如果发生I / O错误