BufferedWriter

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.io
类 BufferedWriter

java.lang.Object
  java.io.Writer
      java.io.BufferedWriter

所有已实现的接口：: Closeable, Flushable, Appendable

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

字段摘要

从类 java.io.Writer 继承的字段
`lock`

构造方法摘要
`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.Writer 继承的方法
`append, append, append, write, write`

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

构造方法详细信息

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

写入单个字符。

覆盖：: 类 Writer 中的 write

参数：: c - 指定要写入字符的 int。
抛出：: IOException - 如果发生 I/O 错误

write

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

写入字符数组的某一部分。

一般来说，此方法将给定数组的字符存入此流的缓冲区中，根据需要刷新该缓冲区，并转到底层流。但是，如果请求的长度至少与此缓冲区大小相同，则此方法将刷新该缓冲区并将各个字符直接写入底层流。因此多余的 BufferedWriter 将不必复制数据。

指定者：: 类 Writer 中的 write

参数：: cbuf - 字符数组; off - 开始读取字符处的偏移量; len - 要写入的字符数

抛出：

IOException - 如果发生 I/O 错误

write

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

写入字符串的某一部分。

如果 len 参数的值为负数，则不写入任何字符。这与超类中此方法的规范正好相反，它要求抛出 IndexOutOfBoundsException。

覆盖：: 类 Writer 中的 write

参数：: s - 要写入的字符串; off - 开始读取字符处的偏移量; len - 要写入的字符数

抛出：

IOException - 如果发生 I/O 错误

newLine

public void newLine()
             throws IOException

写入一个行分隔符。行分隔符字符串由系统属性 line.separator 定义，并且不一定是单个新行 ('\n') 符。

抛出：: IOException - 如果发生 I/O 错误

flush

public void flush()
           throws IOException

刷新该流的缓冲。

指定者：: 接口 Flushable 中的 flush
指定者：: 类 Writer 中的 flush

抛出：: IOException - 如果发生 I/O 错误

close

public void close()
           throws IOException

从类 Writer 复制的描述

关闭此流，但要先刷新它。在关闭该流之后，再调用 write() 或 flush() 将导致抛出 IOException。关闭以前关闭的流无效。

指定者：: 接口 Closeable 中的 close
指定者：: 类 Writer 中的 close

抛出：: IOException - 如果发生 I/O 错误

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

java.io 类 BufferedWriter

BufferedWriter

BufferedWriter

write

write

write

newLine

flush

close

java.io
类 BufferedWriter