1. 首页
  2. JavaAPI

Java java.io 类 PrintStream（JDK5）

141 阅读 0 评论

所有类

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

java.io
类 PrintStream

java.lang.Object
  继承者 java.io.OutputStream
      继承者 java.io.FilterOutputStream
          继承者 java.io.PrintStream
所有已实现的接口：
Closeable, Flushable, Appendable
直接已知子类：
LogStream 
public class PrintStream
   
   
   
   
   
extends FilterOutputStream
   
   
   
   
   

   
   
   
   
   
implements Appendable, Closeable

PrintStream 为其他输出流添加了功能，使它们能够方便地打印各种数据值表示形式。它还提供其他两项功能。与其他输出流不同，PrintStream 不会抛出 IOException；而是，异常情况仅设置可通过 checkError 方法测试的内部标志。另外，为了自动刷新，可以创建一个 PrintStream；这意味着可在写入字节数组之后自动调用 flush 方法，可调用其中一个 println 方法，或写入一个新行字符或字节 ('\n')。

PrintStream 打印的所有字符都使用平台的默认字符编码转换为字节。在需要写入字符而不是写入字节的情况下，应该使用 PrintWriter 类。

从以下版本开始：
JDK1.0

字段摘要
 
从类 java.io.FilterOutputStream 继承的字段
out
 
构造方法摘要
PrintStream(File file)
          创建具有指定文件且不带自动行刷新的新打印流。
PrintStream(File file, String csn)
          创建具有指定文件名称和字符集且不带自动行刷新的新打印流。
PrintStream(OutputStream out)
          创建新的打印流。
PrintStream(OutputStream out, boolean autoFlush)
          创建新的打印流。
PrintStream(OutputStream out, boolean autoFlush, String encoding)
          创建新的打印流。
PrintStream(String fileName)
          创建具有指定文件名称且不带自动行刷新的新打印流。
PrintStream(String fileName, String csn)
          创建具有指定文件名称和字符集且不带自动行刷新的新打印流。
 
方法摘要
 PrintStream append(char c)
          向此输出流追加指定字符。
 PrintStream append(CharSequence csq)
          向此输出流追加指定字符序列。
 PrintStream append(CharSequence csq, int start, int end)
          向此输出流追加指定字符序列的子序列。
 boolean checkError()
          刷新流并检查其错误状态。
 void close()
          关闭流。
 void flush()
          刷新流。
 PrintStream format(Locale l, String format, Object... args)
          使用指定格式字符串和参数将格式化字符串写入此输出流中。
 PrintStream format(String format, Object... args)
          使用指定格式字符串和参数将格式化字符串写入此输出流中。
 void print(boolean b)
          打印 boolean 值。
 void print(char c)
          打印字符。
 void print(char[] s)
          打印字符数组。
 void print(double d)
          打印双精度浮点数。
 void print(float f)
          打印浮点数。
 void print(int i)
          打印整数。
 void print(long l)
          打印 long 整数。
 void print(Object obj)
          打印对象。
 void print(String s)
          打印字符串。
 PrintStream printf(Locale l, String format, Object... args)
          使用指定格式字符串和参数将格式化的字符串写入此输出流的便捷方法。
 PrintStream printf(String format, Object... args)
          使用指定格式字符串和参数将格式化的字符串写入此输出流的便捷方法。
 void println()
          通过写入行分隔符字符串终止当前行。
 void println(boolean x)
          打印 boolean 值，然后终止行。
 void println(char x)
          打印字符，然后终止该行。
 void println(char[] x)
          打印字符数组，然后终止该行。
 void println(double x)
          打印 double，然后终止该行。
 void println(float x)
          打印 float，然后终止该行。
 void println(int x)
          打印整数，然后终止该行。
 void println(long x)
          打印 long，然后终止该行。
 void println(Object x)
          打印 Object，然后终止该行。
 void println(String x)
          打印 String，然后终止该行。
protected  void setError()
          将该流的错误状态设置为 true。
 void write(byte[] buf, int off, int len)
          将 len 字节从指定的初始偏移量为 off 的字节数组写入此流。
 void write(int b)
          将指定的字节写入此流。
 
从类 java.io.FilterOutputStream 继承的方法
write
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

PrintStream

public PrintStream(OutputStream out)
创建新的打印流。此流将不会自动刷新。

参数：
out - 将向其打印值和对象的输出流
另请参见：
PrintWriter.PrintWriter(java.io.OutputStream)

PrintStream

public PrintStream(OutputStream out,
                   boolean autoFlush)
创建新的打印流。

参数：
out - 将向其打印值和对象的输出流
autoFlush - boolean 变量；如果为 true，则每当写入字节数组、调用其中一个 println 方法或写入新行字符或字节 ('\n') 时都会刷新输出缓冲区
另请参见：
PrintWriter.PrintWriter(java.io.OutputStream, boolean)

PrintStream

public PrintStream(OutputStream out,
                   boolean autoFlush,
                   String encoding)
            throws UnsupportedEncodingException
创建新的打印流。

参数：
out - 将向其打印值和对象的输出流
autoFlush - boolean 变量；如果为 true，则每当写入字节数组、调用其中一个 println 方法或写入新行字符或字节 ('\n') 时都会刷新缓冲区
encoding - 受支持的字符编码的名称
抛出：
UnsupportedEncodingException - 如果不支持指定的编码

PrintStream

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

参数：
fileName - 要用作此打印流目标的文件名称。如果存在该文件，则将其大小截取为零；否则，创建一个新文件。将输出写入文件中，并对其进行缓冲处理。
抛出：
FileNotFoundException - 如果给定的文件对象不表示现有的可写常规文件，并且无法创建该名称的新常规文件，或者在打开或创建文件时发生其他一些错误
SecurityException - 如果存在安全管理器，并且 checkWrite(fileName) 拒绝对文件进行写入访问。
从以下版本开始：
1.5

PrintStream

public PrintStream(String fileName,
                   String csn)
            throws FileNotFoundException,
                   UnsupportedEncodingException
创建具有指定文件名称和字符集且不带自动行刷新的新打印流。此便捷构造方法创建必要的中间 OutputStreamWriter，后者将使用提供的字符集进行字符编码。

参数：
fileName - 要用作此打印流目标的文件名称。如果存在该文件，则将其大小截取为零；否则，创建一个新文件。将输出写入文件中，并对其进行缓冲处理。
csn - 受支持的字符集的名称
抛出：
FileNotFoundException - 如果给定的文件对象不表示现有的可写常规文件，并且无法创建该名称的新常规文件，或者在打开或创建文件时发生其他一些错误
SecurityException - 如果存在安全管理器，并且 checkWrite(fileName) 拒绝对文件进行写入访问。
UnsupportedEncodingException - 如果不支持指定字符集
从以下版本开始：
1.5

PrintStream

public PrintStream(File file)
            throws FileNotFoundException
创建具有指定文件且不带自动行刷新的新打印流。此便捷构造方法创建必要的中间 OutputStreamWriter，后者将使用此 Java 虚拟机实例的默认 charset 进行字符编码。

参数：
file - 要用作此打印流目标的文件。如果存在该文件，则将其大小截取为零；否则，创建一个新文件。将输出写入文件中，并对其进行缓冲处理。
抛出：
FileNotFoundException - 如果给定的文件对象不表示现有的可写常规文件，并且无法创建该名称的新常规文件，或者在打开或创建文件时发生其他一些错误
SecurityException - 如果存在安全管理器，并且 checkWrite(file.getPath()) 拒绝对文件进行写入访问。
从以下版本开始：
1.5

PrintStream

public PrintStream(File file,
                   String csn)
            throws FileNotFoundException,
                   UnsupportedEncodingException
创建具有指定文件名称和字符集且不带自动行刷新的新打印流。此便捷构造方法创建必要的中间 OutputStreamWriter，后者将使用提供的字符集进行字符编码。

参数：
file - 要用作此打印流目标的文件。如果存在该文件，则将其大小截取为零；否则，创建一个新文件。将输出写入文件中，并对其进行缓冲处理。
csn - 受支持的字符集的名称
抛出：
FileNotFoundException - 如果给定的文件对象不表示现有的可写常规文件，并且无法创建该名称的新常规文件，或者在打开或创建文件时发生其他一些错误
SecurityException - 如果存在安全管理器，并且 checkWrite(file.getPath()) 拒绝对文件进行写入访问
UnsupportedEncodingException - 如果不支持指定字符集
从以下版本开始：
1.5
方法详细信息

flush

public void flush()
刷新流。通过将所有缓冲的输出字节写入到基础输出流然后刷新该流的缓冲，完成此操作。

指定者：
接口 Flushable 中的 flush
覆盖：
类 FilterOutputStream 中的 flush
另请参见：
OutputStream.flush()

微信小程序

微信扫一扫体验

微信公众账号

微信扫一扫加关注

 发表
评论 返回
顶部