类 java.io.PrintStream

java.lang.Object
   |
   +----java.io.OutputStream
           |
           +----java.io.FilterOutputStream
                   |
                   +----java.io.PrintStream

public class PrintStream

extends FilterOutputStream

下列类的父类：

LogStream

使用平台缺省的字符编码方式将字符转换成字节后，将数据值和对象打印到输出流。

如果流创建时允许自动刷新，那么当每次行结束或写入一个新的行字符时，此流均被刷新。

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

注释： 这个类主要用于调试，同已有代码兼容；新代码应使用 PrintWriter 类。

来自：

JDK1.0

参见：

PrintWriter

构造子索引

PrintStream(OutputStream)

创建一个新的打印流。 不推荐使用该方法。

PrintStream(OutputStream, boolean)

创建一个新的 PrintStream。 不推荐使用该方法。

方法索引

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(byte[], int, int)

写入一个字节数组的某部分，如果必要则阻塞。

write(int)

写入一个字节，如果必要则阻塞。

构造子

 public PrintStream(OutputStream out)

注释：不推荐使用 PrintStream() 方法。 同 JDK 1.1 版中的类似，打印文本的最佳方法是采用 PrintWriter 类。考虑置换代码
格式是   PrintStream p = new PrintStream(out);
为   PrintWriter p = new PrintWriter(out);

创建一个新的打印流。

参数：

out - 值和对象将被打印到的输出流。

参见：

PrintWriter

 public PrintStream(OutputStream out,
                    boolean autoFlush)

注释：不推荐使用 PrintStream() 方法。 同 JDK 1.1 版中的类似，打印文本的最佳方法是采用 PrintWriter 类。考虑置换代码
格式   PrintStream p = new PrintStream(out, autoFlush);
用   PrintWriter p = new PrintWriter(out, autoFlush);

创建一个新的 PrintStream。

参数：

out - 值和对象将被打印到的输出流。

autoFlush - 一个布尔值; 如果为真，则当一行终止或写入一个换行字符('\n')时，刷新输出缓冲区。

参见：

PrintWriter

方法

 public void flush()

刷新流。 将任一缓冲字节写入基本输出流，然后刷新此流。

覆盖：

类 FilterOutputStream 中的 flush

参见：

flush

 public void close()

关闭流。该操作通过刷新该流，并关闭基本输出流实现。

覆盖：

close 类 FilterOutputStream

参见：

close

 public boolean checkError()

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

返回值：

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

 protected void setError()

标记产生一个错误。

 public void write(int b)

写入一个字节，如果必要则阻塞。 如果此字符是一个换行标记且可以自动刷新，那么调用流的 flush 方法。

注意按给定的字节写入；根据平台的缺省字符编码先进行字符转换，然后再使用 print(char) 或 println(char) 方法将字符写入。

参数：

b - 被写入的字节

覆盖：

类 FilterOutputStream 中的 write

参见：

print, println

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

写入一个字节数组的某部分，如果必要则阻塞。

参数：

buf - 一个字节数组

off - 开始取字符的串偏移

len - 写入的字节数

覆盖：

类 FilterOutputStream 中的 write

 public void print(boolean b)

打印一个布尔值。 如果给定值为 true, 那么将串 "true" 写入基本输出流；否则写入串 "false"。

参数：

b - 打印的 boolean值

 public void print(char c)

打印一个字符。 根据平台的缺省字符编码方式，将此字符转换为一个或多个字节。

参数：

c - 被打印的 char

 public void print(int i)

打印一个整型数。 当用给定的 int 值调用类 Integer 的 toString 方法时，返回的串与本方法打印的串相同。

参数：

i - 被打印的 int 值

参见：

toString

 public void print(long l)

打印一个长整型数。 当用给定的 long 值调用类 Long 的 toString 方法时，返回的串与本方法打印的串相同。

参数：

l - 被打印的 long 值

参见：

toString

 public void print(float f)

打印一个浮点数。 当用给定的 float 值调用类 Float 的 toString 方法时，返回的串与本方法打印的串相同。

参数：

f - 被打印的 float 值

参见：

toString

 public void print(double d)

打印一个双精度浮点数。 当用给定的 double 值调用类 Double 的 toString 方法时，返回的串与本方法打印的串相同。

参数：

d - 被打印的 double 值

参见：

toString

 public void print(char s[])

打印一个字符数组。 根据平台的缺省字符编码方式，将这些字符转换为相应字节。

参数：

s - 被打印的字符数组

 public void print(String s)

打印一个串。 如果参数为 null, 则将串 "null" 写入基本输出流。否则，根据平台的缺省字符编码方式，将此串的字符转换为相应字节。

参数：

s - 被打印的 String

 public void print(Object obj)

打印一个对象。 打印串与给定对象的 toString 方法返回的串相同。

参数：

obj - 打印的 Object

参见：

toString

 public void println()

通过写入一个行分隔符结束当前行。 系统属性 line.separator 定义行分隔符串, 不必一定是单一的换行字符 ('\n')。

 public void println(boolean x)

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

参见：

print

 public void println(char x)

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

参见：

print

 public void println(int x)

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

参见：

print

 public void println(long x)

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

参见：

print

 public void println(float x)

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

参见：

print

 public void println(double x)

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

参见：

print

 public void println(char x[])

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

参见：

print

 public void println(String x)

打印一个串，结束此行。

参见：

print

 public void println(Object x)

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

参见：

print