Java java.io 类 PrintWriter（JDK5）

所有类

概述  软件包   类  使用  树  已过时  索引  帮助
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

java.io
类 PrintWriter

java.lang.Object
  java.io.Writer
      java.io.PrintWriter

所有已实现的接口：

Closeable, Flushable, Appendable

---

public class PrintWriter
   
   
   
   
   
extends Writer
   
   
   
   
   

向文本输出流打印对象的格式化表示形式。此类实现在 PrintStream 中的所有 print 方法。它不包含用于写入原始字节的方法，对于这些字节，程序应该使用未编码的字节流进行写入。

与 PrintStream 类不同，如果启用了自动刷新，则只有在调用 println、printf 或 format 的其中一个方法时才可能完成此操作，而不是每当正好输出新行字符时才完成。这些方法使用平台自有的行分隔符概念，而不是新行字符。

此类中的方法不会抛出 I/O 异常，尽管其某些构造方法可能抛出异常。客户端可能会查询调用 checkError() 是否出现错误。

从以下版本开始：

JDK1.1

---

字段摘要
protected  Writer	out           此 PrintWriter 的基础字符输出流。

 

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

 

构造方法摘要
PrintWriter(File file)           使用指定文件创建不具有自动行刷新的新 PrintWriter。
PrintWriter(File file, String csn)           创建具有指定文件和字符集且不带自动刷行新的新 PrintWriter。
PrintWriter(OutputStream out)           根据现有的 OutputStream 创建不带自动行刷新的新 PrintWriter。
PrintWriter(OutputStream out, boolean autoFlush)           通过现有的 OutputStream 创建新的 PrintWriter。
PrintWriter(String fileName)           创建具有指定文件名称且不带自动行刷新的新 PrintWriter。
PrintWriter(String fileName, String csn)           创建具有指定文件名称和字符集且不带自动行刷新的新 PrintWriter。
PrintWriter(Writer out)           创建不带自动行刷新的新 PrintWriter。
PrintWriter(Writer out, boolean autoFlush)           创建新 PrintWriter。

 

方法摘要
PrintWriter	append(char c)           将指定字符追加到此 writer。
PrintWriter	append(CharSequence csq)           将指定的字符序列追加到此 writer。
PrintWriter	append(CharSequence csq, int start, int end)           将指定字符序列的子序列追加到此 writer。
boolean	checkError()           如果流没有关闭，则刷新流且检查其错误状态。
void	close()           关闭该流。
void	flush()           刷新该流的缓冲。
PrintWriter	format(Locale l, String format, Object... args)           使用指定格式字符串和参数将一个格式化字符串写入此 writer 中。
PrintWriter	format(String format, Object... args)           使用指定格式字符串和参数将一个格式化字符串写入此 writer 中。
void	print(boolean b)           打印 boolean 值。
void	print(char c)           打印字符。
void	print(char[] s)           打印字符数组。
void	print(double d)           打印 double 精度浮点数。
void	print(float f)           打印一个浮点数。
void	print(int i)           打印整数。
void	print(long l)           打印 long 整数。
void	print(Object obj)           打印对象。
void	print(String s)           打印字符串。
PrintWriter	printf(Locale l, String format, Object... args)           使用指定格式字符串和参数将格式化的字符串写入此 writer 的便捷方法。
PrintWriter	printf(String format, Object... args)           使用指定格式字符串和参数将格式化的字符串写入此 writer 的便捷方法。
void	println()           通过写入行分隔符字符串终止当前行。
void	println(boolean x)           打印 boolean 值，然后终止该行。
void	println(char x)           打印字符，然后终止该行。
void	println(char[] x)           打印字符数组，然后终止该行。
void	println(double x)           打印双精度浮点数，然后终止该行。
void	println(float x)           打印浮点数，然后终止该行。
void	println(int x)           打印整数，然后终止该行。
void	println(long x)           打印 long 整数，然后终止该行。
void	println(Object x)           打印 Object，然后终止该行。
void	println(String x)           打印 String，然后终止该行。
protected  void	setError()           指示已发生错误。
void	write(char[] buf)           写入字符数组。
void	write(char[] buf, int off, int len)           写入字符数组的某一部分。
void	write(int c)           写入单个字符。
void	write(String s)           写入字符串。
void	write(String s, int off, int len)           写入字符串的某一部分。

 

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

 

字段详细信息

out

protected Writer out

此 PrintWriter 的基础字符输出流。

从以下版本开始：

1.2

构造方法详细信息

PrintWriter

public PrintWriter(Writer out)

创建不带自动行刷新的新 PrintWriter。

参数：

out - 字符输出流

---

PrintWriter

public PrintWriter(Writer out,
                   boolean autoFlush)

创建新 PrintWriter。

参数：

out - 字符输出流

autoFlush - boolean 变量；如果为 true，则 println、printf 或 format 方法将刷新输出缓冲区

---

PrintWriter

public PrintWriter(OutputStream out)

根据现有的 OutputStream 创建不带自动行刷新的新 PrintWriter。此便捷构造方法创建必要的中间 OutputStreamWriter，后者使用默认字符编码将字符转换为字节。

参数：

out - 输出流

另请参见：

OutputStreamWriter.OutputStreamWriter(java.io.OutputStream)

---

PrintWriter

public PrintWriter(OutputStream out,
                   boolean autoFlush)

通过现有的 OutputStream 创建新的 PrintWriter。此便捷构造方法创建必要的中间 OutputStreamWriter，后者使用默认字符编码将字符转换为字节。

参数：

out - 输出流

autoFlush - boolean 变量；如果为 true，则 println、printf 或 format 方法将刷新输出缓冲区

另请参见：

OutputStreamWriter.OutputStreamWriter(java.io.OutputStream)

---

PrintWriter

public PrintWriter(String fileName)
            throws FileNotFoundException

创建具有指定文件名称且不带自动行刷新的新 PrintWriter。此便捷构造方法创建必要的中间 OutputStreamWriter，后者将使用此 Java 虚拟机实例的默认 charset 进行字符编码。

参数：

fileName - 用作此 writer 目标的文件名称。如果存在该文件，则将其大小截取为零；否则，创建一个新文件。将输出写入文件中，并对其进行缓冲处理。

抛出：

FileNotFoundException - 如果给定的字符串不表示现有的可写常规文件，并且无法创建该名称的新常规文件，或者在打开或创建文件时发生其他一些错误

SecurityException - 如果存在安全管理器，并且 checkWrite(fileName) 拒绝对文件进行写入访问。

从以下版本开始：

1.5

---

PrintWriter

public PrintWriter(String fileName,
                   String csn)
            throws FileNotFoundException,
                   UnsupportedEncodingException

创建具有指定文件名称和字符集且不带自动行刷新的新 PrintWriter。此便捷构造方法创建必要的中间 OutputStreamWriter，后者将使用提供的字符集进行字符编码。

参数：

fileName - 用作此 writer 目标的文件名称。如果存在该文件，则将其大小截取为零；否则，创建一个新文件。将输出写入文件中，并对其进行缓冲处理。

csn - 受支持的字符集的名称

抛出：

FileNotFoundException - 如果给定的字符串不表示现有的可写常规文件，并且无法创建该名称的新常规文件，或者在打开或创建文件时发生其他一些错误

SecurityException - 如果存在安全管理器，并且 checkWrite(fileName) 拒绝对文件进行写入访问。

UnsupportedEncodingException - 如果不支持指定字符集

从以下版本开始：

1.5

---

PrintWriter

public PrintWriter(File file)
            throws FileNotFoundException

使用指定文件创建不具有自动行刷新的新 PrintWriter。此便捷构造方法创建必要的中间 OutputStreamWriter，后者将使用此 Java 虚拟机实例的默认 charset 进行字符编码。

参数：

file - 作为此 writer 的目标使用的文件。如果存在该文件，则将其大小截取为零；否则，创建一个新文件。将输出写入文件中，并对其进行缓冲处理。

抛出：

FileNotFoundException - 如果给定的文件对象不表示现有的可写常规文件，并且无法创建该名称的新常规文件，或者在打开或创建文件时发生其他一些错误

SecurityException - 如果存在安全管理器，并且 checkWrite(file.getPath()) 拒绝对文件进行写入访问。

从以下版本开始：

1.5