PrintWriter (Java Platform SE 8 )

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

All Implemented Interfaces:

Closeable， Flushable， Appendable， AutoCloseable
```
public class PrintWriter
extends Writer
```
将对象的格式化的表示形式打印到文本输出流中。这个类实现了所有发现的 print PrintStream方法。它不包含写作原始字节的方法，其中一个程序应该使用未编码的字节流。
不像PrintStream类，如果启用自动冲洗就只能当一个人的println，printf，或format方法被调用时，而不是当一个换行符会输出。这些方法使用平台的概念，而不是换行符分隔符。

在这个类中的方法从来没有抛出I / O异常，虽然它的一些构造函数可能。客户可以询问是否有任何错误的调用checkError()发生。

从以下版本开始：

JDK1.1

Field Summary

Fields
Modifier and Type	Field and Description
`protected Writer`	`out` 下面这 `PrintWriter`字符输出流。

Fields inherited from class java.io.Writer
lock

构造方法摘要

构造方法
Constructor and Description
`PrintWriter(File file)` 创建一个新的PrintWriter，无线自动冲洗，用指定的文件。
`PrintWriter(File file, String csn)` 创建一个新的PrintWriter，无线自动冲洗，用指定的文件和字符集。
`PrintWriter(OutputStream out)` 创建一个新的PrintWriter，无线自动冲洗，从现有的OutputStream。
`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。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`PrintWriter`	`append(char c)` 将指定的字符到这个作家。
`PrintWriter`	`append(CharSequence csq)` 将指定的字符序列，这个作家。
`PrintWriter`	`append(CharSequence csq, int start, int end)` 添加一个序列指定的字符序列，这个作家。
`boolean`	`checkError()` 刷新流如果不是封闭的，检查它的错误状态。
`protected void`	`clearError()` 清除此流的错误状态。
`void`	`close()` 关闭流并释放与它相关联的任何系统资源。
`void`	`flush()` 冲流。
`PrintWriter`	`format(Locale l, String format, Object... args)` 使用指定的格式字符串和参数将格式化的字符串写入到这个写作者。
`PrintWriter`	`format(String format, Object... args)` 使用指定的格式字符串和参数将格式化的字符串写入到这个写作者。
`void`	`print(boolean b)` 打印布尔值。
`void`	`print(char c)` 打印一个字符。
`void`	`print(char[] s)` 打印一个字符数组。
`void`	`print(double d)` 打印一个双精度浮点数。
`void`	`print(float f)` 打印一个浮点数。
`void`	`print(int i)` 打印一个整数。
`void`	`print(long l)` 打印一个长整数。
`void`	`print(Object obj)` 打印一个对象。
`void`	`print(String s)` 打印一个字符串。
`PrintWriter`	`printf(Locale l, String format, Object... args)` 使用指定的格式字符串和参数编写格式化字符串的方便方法。
`PrintWriter`	`printf(String format, Object... args)` 使用指定的格式字符串和参数编写格式化字符串的方便方法。
`void`	`println()` 通过编写行分隔符终止当前行。
`void`	`println(boolean x)` 打印一个布尔值，然后终止该行。
`void`	`println(char x)` 打印一个字符，然后终止行。
`void`	`println(char[] x)` 打印一个字符数组，然后终止行。
`void`	`println(double x)` 打印一个双精度浮点数，然后终止行。
`void`	`println(float x)` 打印一个浮点数，然后终止该行。
`void`	`println(int x)` 打印一个整数，然后终止行。
`void`	`println(long x)` 打印一个长整数，然后终止行。
`void`	`println(Object x)` 打印一个对象，然后终止该行。
`void`	`println(String x)` 打印一个字符串，然后终止行。
`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)` 写入字符串的一部分。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - out
```
protected Writer out
```
    下面这 PrintWriter字符输出流。
    
    从以下版本开始：
    
    一点二
- Constructor Detail
  - PrintWriter
```
public PrintWriter(Writer out)
```
    创建一个新的PrintWriter，无线自动冲洗。
    
    参数
    
    out -字符输出流
  - PrintWriter
```
public PrintWriter(Writer out,
                   boolean autoFlush)
```
    创建一个新的PrintWriter。
    
    参数
    
    out -字符输出流
    
    autoFlush -布尔；如果真的 println， printf，或 format方法将刷新输出缓冲区
  - PrintWriter
```
public PrintWriter(OutputStream out)
```
    创建一个新的PrintWriter，无线自动冲洗，从现有的OutputStream。这种便利的构造函数创建必要的中间outputstreamwriter将字符转换为字节，将使用默认的字符编码。
    
    参数
    
    out -输出流
    
    另请参见：
    
    OutputStreamWriter.OutputStreamWriter(java.io.OutputStream)
  - PrintWriter
```
public PrintWriter(OutputStream out,
                   boolean autoFlush)
```
    创建从现有的OutputStream新PrintWriter。这种便利的构造函数创建必要的中间outputstreamwriter将字符转换为字节，将使用默认的字符编码。
    
    参数
    
    out -输出流
    
    autoFlush -布尔；如果真的 println， printf，或 format方法将刷新输出缓冲区
    
    另请参见：
    
    OutputStreamWriter.OutputStreamWriter(java.io.OutputStream)
  - PrintWriter
```
public PrintWriter(String fileName)
            throws FileNotFoundException
```
    创建一个新的PrintWriter，无线自动冲洗，用指定的文件名。这种便利的构造函数创建必要的中间 OutputStreamWriter，将编码字符使用 default charset这个java虚拟机实例。
    
    参数
    
    fileName -该文件的名称作为笔者的目的地。如果文件存在，则它将被截断为零；否则，将创建一个新的文件。输出将被写入到文件，并缓冲。
    
    异常
    
    FileNotFoundException如果给定字符串不是指现有的，写普通文件和一个新的名字不能创造规则的文件，或者一些其他的错误发生在打开或创建文件
    
    SecurityException -如果一个安全管理是当前和 checkWrite(fileName)否认文件的写访问
    
    从以下版本开始：
    
    一点五
  - PrintWriter
```
public PrintWriter(String fileName,
                   String csn)
            throws FileNotFoundException,
                   UnsupportedEncodingException
```
    创建一个新的PrintWriter，无线自动冲洗，用指定的文件名和字符集。这种便利的构造函数创建必要的中间 OutputStreamWriter，将编码字符的使用提供的字符集。
    
    参数
    
    fileName -该文件的名称作为笔者的目的地。如果文件存在，则它将被截断为零；否则，将创建一个新的文件。输出将被写入到文件，并缓冲。
    
    csn -支持的 charset名称
    
    异常
    
    FileNotFoundException如果给定字符串不是指现有的，写普通文件和一个新的名字不能创造规则的文件，或者一些其他的错误发生在打开或创建文件
    
    SecurityException -如果一个安全管理是当前和 checkWrite(fileName)否认文件的写访问
    
    UnsupportedEncodingException -如果指定的字符集不支持
    
    从以下版本开始：
    
    一点五
  - PrintWriter
```
public PrintWriter(File file)
            throws FileNotFoundException
```
    创建一个新的PrintWriter，无线自动冲洗，用指定的文件。这种便利的构造函数创建必要的中间 OutputStreamWriter，将编码字符使用 default charset这个java虚拟机实例。
    
    参数
    
    file -文件作为笔者的目的地。如果文件存在，则它将被截断为零；否则，将创建一个新的文件。输出将被写入到文件，并缓冲。
    
    异常
    
    FileNotFoundException -如果指定文件对象不表示一个存在，可写普通文件和一个新的名字不能创造规则的文件，或者一些其他的错误发生在打开或创建文件
    
    SecurityException -如果一个安全管理是当前和 checkWrite(file.getPath())否认文件的写访问
    
    从以下版本开始：
    
    一点五
  - PrintWriter
```
public PrintWriter(File file,
                   String csn)
            throws FileNotFoundException,
                   UnsupportedEncodingException
```
    创建一个新的PrintWriter，无线自动冲洗，用指定的文件和字符集。这种便利的构造函数创建必要的中间 OutputStreamWriter，将编码字符的使用提供的字符集。
    
    参数
    
    file -文件作为笔者的目的地。如果文件存在，则它将被截断为零；否则，将创建一个新的文件。输出将被写入到文件，并缓冲。
    
    csn -支持的 charset名称
    
    异常
    
    FileNotFoundException -如果指定文件对象不表示一个存在，可写普通文件和一个新的名字不能创造规则的文件，或者一些其他的错误发生在打开或创建文件
    
    SecurityException -如果一个安全管理是当前和 checkWrite(file.getPath())否认文件的写访问
    
    UnsupportedEncodingException -如果指定的字符集不支持
    
    从以下版本开始：
    
    一点五
- 方法详细信息
  - flush
```
public void flush()
```
    冲流。
    
    Specified by:
    
    flush 接口 Flushable
    
    Specified by:
    
    flush 方法重写，继承类 Writer
    
    另请参见：
    
    checkError()
  - close
```
public void close()
```
    关闭流并释放与它相关联的任何系统资源。关闭先前关闭的流没有影响。
    
    Specified by:
    
    close 接口 Closeable
    
    Specified by:
    
    close 接口 AutoCloseable
    
    Specified by:
    
    close 方法重写，继承类 Writer
    
    另请参见：
    
    checkError()
  - checkError
```
public boolean checkError()
```
    刷新流如果不是封闭的，检查它的错误状态。
    
    结果
    
    true如果打印流遇到了一个错误，在下面的输出流或格式转换过程中。
  - setError
```
protected void setError()
```
    指示发生了一个错误。
    这种方法会造成后续的调用之前调用checkError() clearError() true返回。
  - clearError
```
protected void clearError()
```
    清除此流的错误状态。
    这种方法会造成后续的调用checkError()返回false直到另一个写操作失败并调用setError()。
    
    从以下版本开始：
    
    一点六
  - write
```
public void write(int c)
```
    写一个字符。
    
    重写：
    
    write 方法重写，继承类 Writer
    
    参数
    
    c - int指定要写入的字符。
  - write
```
public void write(char[] buf,
                  int off,
                  int len)
```
    写入一个字符数组的一部分。
    
    Specified by:
    
    write 方法重写，继承类 Writer
    
    参数
    
    buf -字符数组
    
    偏移量从 off -开始写作的特点
    
    len数字写
  - write
```
public void write(char[] buf)
```
    写一个字符数组。这种方法不能从“写者”类继承，因为它必须抑制I / O异常。
    
    重写：
    
    write 方法重写，继承类 Writer
    
    参数
    
    buf -要写入的字符数组
  - write
```
public void write(String s,
                  int off,
                  int len)
```
    写入字符串的一部分。
    
    重写：
    
    write 方法重写，继承类 Writer
    
    参数
    
    s -一个字符串
    
    off偏移从开始写汉字
    
    len数字写
  - write
```
public void write(String s)
```
    写一个字符串。这种方法不能从“写者”类继承，因为它必须抑制I / O异常。
    
    重写：
    
    write 方法重写，继承类 Writer
    
    参数
    
    s字符串被写入
  - print
```
public void print(boolean b)
```
    打印布尔值。由 String.valueOf(boolean)字符串翻译根据平台的默认字符编码为字节，这些字节的方法完全 write(int)方式写。
    
    参数
    
    b - boolean要打印
  - print
```
public void print(char c)
```
    打印一个字符。文字翻译根据平台的默认字符编码成一个或多个字节，这些字节的方法完全 write(int)方式写。
    
    参数
    
    c - char要打印
  - print
```
public void print(int i)
```
    打印一个整数。由 String.valueOf(int)字符串翻译根据平台的默认字符编码为字节，这些字节的方法完全 write(int)方式写。
    
    参数
    
    i - int要打印
    
    另请参见：
    
    Integer.toString(int)
  - print
```
public void print(long l)
```
    打印一个长整数。由 String.valueOf(long)字符串翻译根据平台的默认字符编码为字节，这些字节的方法完全 write(int)方式写。
    
    参数
    
    l - long要打印
    
    另请参见：
    
    Long.toString(long)
  - print
```
public void print(float f)
```
    打印一个浮点数。由 String.valueOf(float)字符串翻译根据平台的默认字符编码为字节，这些字节的方法完全 write(int)方式写。
    
    参数
    
    f - float要打印
    
    另请参见：
    
    Float.toString(float)
  - print
```
public void print(double d)
```
    打印一个双精度浮点数。由 String.valueOf(double)字符串翻译根据平台的默认字符编码为字节，这些字节的方法完全 write(int)方式写。
    
    参数
    
    d - double要打印
    
    另请参见：
    
    Double.toString(double)
  - print
```
public void print(char[] s)
```
    打印一个字符数组。人物是根据平台的默认字符编码转换成字节，这些字节的方法完全 write(int)方式写。
    
    参数
    
    s -焦要打印的阵列
    
    异常
    
    如果是 null s NullPointerException
  - print
```
public void print(String s)
```
    打印一个字符串。如果参数是 null然后串 "null"印刷。否则，该字符串的字符是根据平台的默认字符编码转换成字节，这些字节的方法完全 write(int)方式写。
    
    参数
    
    s - String要打印
  - print
```
public void print(Object obj)
```
    打印一个对象。由 String.valueOf(Object)方法产生的字符串翻译根据平台的默认字符编码为字节，这些字节的方法完全 write(int)方式写。
    
    参数
    
    obj - Object要打印
    
    另请参见：
    
    Object.toString()
  - println
```
public void println()
```
    通过编写行分隔符终止当前行。行分隔符字符串是由系统性 line.separator定义，而不一定是一个换行符（ '\n'）。
  - println
```
public void println(boolean x)
```
    打印一个布尔值，然后终止该行。这种方法就像是调用 print(boolean)然后 println()。
    
    参数
    
    x -要打印的 boolean价值
  - println
```
public void println(char x)
```
    打印一个字符，然后终止行。这种方法就像是调用 print(char)然后 println()。
    
    参数
    
    x -要打印的 char价值
  - println
```
public void println(int x)
```
    打印一个整数，然后终止行。这种方法就像是调用 print(int)然后 println()。
    
    参数
    
    x -要打印的 int价值
  - println
```
public void println(long x)
```
    打印一个长整数，然后终止行。这种方法就像是调用 print(long)然后 println()。
    
    参数
    
    x -要打印的 long价值
  - println
```
public void println(float x)
```
    打印一个浮点数，然后终止该行。这种方法就像是调用 print(float)然后 println()。
    
    参数
    
    x -要打印的 float价值
  - println
```
public void println(double x)
```
    打印一个双精度浮点数，然后终止行。这种方法就像是调用 print(double)然后 println()。
    
    参数
    
    x -要打印的 double价值
  - println
```
public void println(char[] x)
```
    打印一个字符数组，然后终止行。这种方法就像是调用 print(char[])然后 println()。
    
    参数
    
    x - char值要打印的阵列
  - println
```
public void println(String x)
```
    打印一个字符串，然后终止行。这种方法就像是调用 print(String)然后 println()。
    
    参数
    
    x -要打印的 String价值
  - println
```
public void println(Object x)
```
    打印一个对象，然后终止该行。该方法在第一个字符串调用。值（x）得到印刷对象的字符串值，然后就像是调用 print(String)然后 println()。
    
    参数
    
    x - Object要打印。
  - printf
```
public PrintWriter printf(String format,
                          Object... args)
```
    使用指定的格式字符串和参数编写格式化字符串的方便方法。如果启用自动刷新，调用此方法将刷新输出缓冲区。
    这种形式的out.printf(format, args)方法调用的行为一样，调用
```
出格式（格式，args）。
```
    参数
    
    format -格式字符串中所描述的 Format string syntax。
    
    args由格式字符串的格式说明符引用的论据。如果有比格式说明符的更多参数，多余的参数会被忽略。参数的数量是可变的，可能是零。参数的最大数量是由一个java数组的定义由 The Java™ Virtual Machine Specification最大尺寸限制。在 null争论的行为取决于 conversion。
    
    结果
    
    这个作家
    
    异常
    
    IllegalFormatException如果格式字符串包含一个非法的语法、格式说明符与给定的参数不兼容，论据不足给定的格式字符串，或者其他非法的条件。对于所有可能的格式错误的规范，看到格式化程序类规范的 Details节。
    
    NullPointerException -如果 format是 null
    
    从以下版本开始：
    
    一点五
  - printf
```
public PrintWriter printf(Locale l,
                          String format,
                          Object... args)
```
    使用指定的格式字符串和参数编写格式化字符串的方便方法。如果启用自动刷新，调用此方法将刷新输出缓冲区。
    这种形式的out.printf(l, format, args)方法调用的行为一样，调用
```
出来。格式（L、格式、参数）
```
    参数
    
    l - locale申请过程中的格式。如果 l是 null然后不采用定位。
    
    format -格式字符串中所描述的 Format string syntax。
    
    args由格式字符串的格式说明符引用的论据。如果有比格式说明符的更多参数，多余的参数会被忽略。参数的数量是可变的，可能是零。参数的最大数量是由一个java数组的定义由 The Java™ Virtual Machine Specification最大尺寸的限制。在 null争论的行为取决于 conversion。
    
    结果
    
    这个作家
    
    异常
    
    IllegalFormatException如果格式字符串包含一个非法的语法、格式说明符与给定的参数不兼容，论据不足给定的格式字符串，或者其他非法的条件。对于所有可能的格式错误的规范，看到格式化程序类规范的 Details节。
    
    NullPointerException -如果 format是 null
    
    从以下版本开始：
    
    一点五
  - format
```
public PrintWriter format(String format,
                          Object... args)
```
    使用指定的格式字符串和参数将格式化的字符串写入到这个写作者。如果启用自动刷新，调用此方法将刷新输出缓冲区。
    经常使用的区域是一个由Locale.getDefault()，无论以前的任何调用此对象的其他格式的方法。
    
    参数
    
    format -格式字符串中所描述的 Format string syntax。
    
    args由格式字符串的格式说明符引用的论据。如果有比格式说明符的更多参数，多余的参数会被忽略。参数的数量是可变的，可能是零。参数的最大数量是由一个java数组的定义由 The Java™ Virtual Machine Specification最大尺寸限制。在 null争论的行为取决于 conversion。
    
    结果
    
    这个作家
    
    异常
    
    IllegalFormatException如果格式字符串包含一个非法的语法、格式说明符与给定的参数不兼容，论据不足给定的格式字符串，或者其他非法的条件。对于所有可能的格式错误的规范，看到格式化程序类规范的 Details节。
    
    NullPointerException -如果 format是 null
    
    从以下版本开始：
    
    一点五
  - format
```
public PrintWriter format(Locale l,
                          String format,
                          Object... args)
```
    使用指定的格式字符串和参数将格式化的字符串写入到这个写作者。如果启用自动刷新，调用此方法将刷新输出缓冲区。
    
    参数
    
    l - locale申请过程中的格式。如果 l是 null然后没有本地化的应用。
    
    format -格式字符串中所描述的 Format string syntax。
    
    args由格式字符串的格式说明符引用的论据。如果有比格式说明符的更多参数，多余的参数会被忽略。参数的数量是可变的，可能是零。参数的最大数量是由一个java数组的定义由 The Java™ Virtual Machine Specification最大尺寸限制。在 null争论的行为取决于 conversion。
    
    结果
    
    这个作家
    
    异常
    
    IllegalFormatException如果格式字符串包含一个非法的语法、格式说明符与给定的参数不兼容，论据不足给定的格式字符串，或者其他非法的条件。对于所有可能的格式错误的规范，看到格式化程序类规范的 Details节。
    
    NullPointerException -如果 format是 null
    
    从以下版本开始：
    
    一点五
  - append
```
public PrintWriter append(CharSequence csq)
```
    将指定的字符序列，这个作家。
    这种形式的out.append(csq)方法调用的行为一样，调用
```
写出来。（CSQ。tostring()）
```
    根据字符序列的csq toString规范，整个序列可能不追加。例如，调用字符缓冲区的toString方法将返回一个序列的内容取决于缓冲区的位置和范围。
    Specified by:
    
    append 接口 Appendable
    
    重写：
    
    append 方法重写，继承类 Writer
    
    参数
    
    csq -字符序列添加。如果 csq是 null，然后四个字 "null"附加到这个作家。
    
    结果
    
    这个作家
    
    从以下版本开始：
    
    一点五
  - append
```
public PrintWriter append(CharSequence csq,
                          int start,
                          int end)
```
    添加一个序列指定的字符序列，这个作家。
    调用这个方法时，csq形式out.append(csq, start, end)不null，表现在完全相同的方式调用
```
写出来。（CSQ。子序列（开始、结束）。tostring()）
```
    Specified by:
    
    append 接口 Appendable
    
    重写：
    
    append 方法重写，继承类 Writer
    
    参数
    
    csq -字符序列的子序列将追加。如果 csq是 null，那么人物将追加好像 csq包含四个字符 "null"。
    
    start -子序列中的第一个字符的索引
    
    end -子序列中的最后一个字符后的字符的索引
    
    结果
    
    这个作家
    
    异常
    
    IndexOutOfBoundsException -如果 start或 end是负面的， start大于 end，或 end大于 csq.length()
    
    从以下版本开始：
    
    一点五
  - append
```
public PrintWriter append(char c)
```
    将指定的字符到这个作家。
    这种形式的out.append(c)方法调用的行为一样，调用
```
外写（c）
```
    Specified by:
    
    append 接口 Appendable
    
    重写：
    
    append 方法重写，继承类 Writer
    
    参数
    
    c - 16位字符追加
    
    结果
    
    这个作家
    
    从以下版本开始：
    
    一点五

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class PrintWriter

Field Summary

Fields inherited from class java.io.Writer

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

out

Constructor Detail

PrintWriter

PrintWriter

PrintWriter

PrintWriter

PrintWriter

PrintWriter

PrintWriter

PrintWriter

方法详细信息

flush

close

checkError

setError

clearError

write

write

write

write

write

print

print

print

print

print

print

print

print

print

println

println

println

println

println

println

println

println

println

println

printf

printf

format

format

append

append

append