类 java.io.PrintWriter

java.lang.Object
   |
   +----java.io.Writer
           |
           +----java.io.PrintWriter

public class PrintWriter

extends Writer

将格式化对象打印到一个文本输出流。这个类实现 PrintStream 中的所有打印方法。不包含写入未处理字节的方法，对于这些字节，一个程序应使用未编码字节流。

同 PrintStream 类不同，如果可以自动刷新，那么仅当在调用 println() 方法之一，而不是在输出一个换行标记时，刷新流。 println() 方法使用该平台自己的行分隔符标记，它不同于通常的换行分隔符。

这个类中的方法不产生 I/O 异常。用户可通过调用 checkError 方法，检查是否有错误发生。

构造子索引

PrintWriter(OutputStream)

据一个存在的 OutputStream，创建一个新的 PrintWriter, 没有自动行刷新功能。

PrintWriter(OutputStream, boolean)

据一个存在的 OutputStream，创建一个新的 PrintWriter。

PrintWriter(Writer)

创建一个新的 PrintWriter, 没有自动行刷新功能。

PrintWriter(Writer, boolean)

创建一个新的 PrintWriter。

方法索引

checkError()

刷新流且检查它的错误状态。

close()

关闭流。

flush()

刷新流。

print(boolean)

打印一个布尔值。

print(char)

打印一个字符。

print(char[])

打印一个字符数组。

print(double)

打印一个双精度浮点数。

print(float)

打印一个单精度浮点数。

print(int)

打印一个整型数。

print(long)

打印一个长整型数。

print(Object)

打印一个对象。

print(String)

打印一个串。

println()

结束行。

println(boolean)

打印一个布尔值后结束此行。

println(char)

打印一个字符后结束此行。

println(char[])

打印一个字符数组后结束此行。

println(double)

打印一个双精度浮点数后结束此行。

println(float)

打印一个单精度浮点数后结束此行。

println(int)

打印一个整数，结束此行。

println(long)

打印一个长整数，结束此行。

println(Object)

打印一个对象，结束此行。

println(String)

打印一个串，结束此行。

setError()

标记产生一个错误。

write(char[])

写入一个字符数组。

write(char[], int, int)

将若干字符写入一个数组中。

write(int)

写入单一字符。

write(String)

写入一串。

write(String, int, int)

写入一串的某部分。

构造子

 public PrintWriter(Writer out)

创建一个新的 PrintWriter, 没有自动行刷新功能。

参数：

out - 一个字符输出流

 public PrintWriter(Writer out,
                    boolean autoFlush)

创建一个新的 PrintWriter。

参数：

out - 一个字符输出流

autoFlush - 一个布尔值；如果为 true, println() 方法将刷新输出缓冲

 public PrintWriter(OutputStream out)

据一个存在的 OutputStream，创建一个新的 PrintWriter, 没有自动行刷新功能。这个简洁的构造子创建必要的 OutputStreamWriter, 它将使用缺省的字符编码将字符转换为字节。

参数：

out - 一个输出流。

参见：

OutputStreamWriter

 public PrintWriter(OutputStream out,
                    boolean autoFlush)

据一个存在的 OutputStream，创建一个新的 PrintWriter。 这个简洁的构造子创建必要的 OutputStreamWriter, 它将使用缺省的字符编码将字符转换为字节。

参数：

out - 一个输出流。

autoFlush - 一个布尔值；如果为 true, println() 方法将刷新输出缓冲

参见：

OutputStreamWriter

方法

 public void flush()

刷新流。

覆盖：

类 Writer 中的 flush

 public void close()

关闭流。

覆盖：

类 Writer 中的 close

 public boolean checkError()

刷新流且检查它的错误状态。 错误是积累的；一旦该流发现一个错误，这个例程将对所有的后继调用返回 true。

返回值：

如果在基本的输出流上或在一个格式转换期间，打印流遇到一错误，则为 True。

 protected void setError()

标记产生一个错误。

 public void write(int c)

写入单一字符。

覆盖：

类 Writer 中的 write

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

将若干字符写入一个数组中。

覆盖：

类 Writer 中的 write

 public void write(char buf[])

写入一个字符数组。 这个方法不能从 Writer 类继承，因为它必须抑制 I/O 异常。

覆盖：

类 Writer 中的 write

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

写入一串的某部分。

覆盖：

类 Writer 中的 write

 public void write(String s)

写入一串。 这个方法不能从 Writer 类继承，因为它必须抑制 I/O 异常。

覆盖：

类 Writer 中的 write

 public void print(boolean b)

打印一个布尔值。

 public void print(char c)

打印一个字符。

 public void print(int i)

打印一个整型数。

 public void print(long l)

打印一个长整型数。

 public void print(float f)

打印一个单精度浮点数。

 public void print(double d)

打印一个双精度浮点数。

 public void print(char s[])

打印一个字符数组。

 public void print(String s)

打印一个串。

 public void print(Object obj)

打印一个对象。

 public void println()

结束行。

 public void println(boolean x)

打印一个布尔值后结束此行。

 public void println(char x)

打印一个字符后结束此行。

 public void println(int x)

打印一个整数，结束此行。

 public void println(long x)

打印一个长整数，结束此行。

 public void println(float x)

打印一个单精度浮点数后结束此行。

 public void println(double x)

打印一个双精度浮点数后结束此行。

 public void println(char x[])

打印一个字符数组后结束此行。

 public void println(String x)

打印一个串，结束此行。

 public void println(Object x)

打印一个对象，结束此行。