PrintStream 介绍

dk1.7.40)
1 package java.io; 2 3 import java.util.Formatter;
3 / 19
4 import java.util.Locale; 5 import java.nio.charset.Charset; 6 import java.nio.charset.IllegalCharsetNameException; 7 import java.nio.charset.UnsupportedCharsetException; 8 9 public class PrintStream extends FilterOutputStream 10 11 { 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 { requireNonNull(csn, "charsetName"); try { return Charset.forName(csn); } catch (IllegalCharsetNameException|UnsupportedCharsetException unused) { // UnsupportedEncodingException should be thrown throw new UnsupportedEncodingException(csn); 4 / 19 // 返回 csn 对应的字符集对象 private static Charset toCharset(String csn) throws UnsupportedEncodingException } private static <T> T requireNonNull(T obj, String message) { if (obj == null) throw new NullPointerException(message); return obj; // BufferedWriter 对象，用于实现“PrintStream 支持字符集”。 // 因为 PrintStream 是 OutputStream 的子类，所以它本身不支持字符串； // 但是 BufferedWriter 支持字符集，因此可以通过 OutputStreamWriter 创建 PrintStream 对应的 private BufferedWriter textOut; private OutputStreamWriter charOut; // 自动 flush // 所谓“自动 flush”，就是每次执行 print(), println(), write()函数，都会调用 flush()函数； // 而“不自动 flush”，则需要我们手动调用 flush()接口。 private final boolean autoFlush; // PrintStream 是否右产生异常。当 PrintStream 有异常产生时，会被本身捕获，并设置 trouble 为 true private boolean trouble = false; // 用于格式化的对象 private Formatter formatter; implements Appendable, Closeable
注意：print()和 println()都是将其中参数转换成字符串之后，再写入到输入流。 例如， print(0x61); 等价于 write(String.valueOf(0x61)); 上面语句是将字符串"97"写入到输出流。0x61 对应十进制数是 97。 write(0x61) 上面语句是将字符'a'写入到输出流。因为 0x61 对应的 ASCII 码的字母'a'。 查看下面的代码，我们能对这些函数有更清晰的认识！
PrintStream 函数列表
/* * 构造函数 */ // 将“输出流 out”作为 PrintStream 的输出流，不会自动 flush，并且采用默认字符集 // 所谓“自动 flush”，就是每次执行 print(), println(), write()函数，都会调用 flush()函数； // 而“不自动 flush”，则需要我们手动调用 flush()接口。 PrintStream(OutputStream out) // 将“输出流 out”作为 PrintStream 的输出流，自动 flush，并且采用默认字符集。 PrintStream(OutputStream out, boolean autoFlush) // 将“输出流 out”作为 PrintStream 的输出流，自动 flush，采用 charsetName 字符集。 PrintStream(OutputStream out, boolean autoFlush, String charsetName) // 创建 file 对应的 FileOutputStream，然后将该 FileOutputStream 作为 PrintStream 的输出流，不自动 flush，采用默 认字符集。 PrintStream(File file) // 创建 file 对应的 FileOutputStream，然后将该 FileOutputStream 作为 PrintStream 的输出流，不自动 flush，采用 charsetName 字符集。 PrintStream(File file, String charsetName) // 创建 fileName 对应的 FileOutputStream，然后将该 FileOutputStream 作为 PrintStream 的输出流，不自动 flush，采 用默认字符集。 PrintStream(String fileName) // 创建 fileName 对应的 FileOutputStream，然后将该 FileOutputStream 作为 PrintStream 的输出流，不自动 flush，采 用 charsetName 字符集。 PrintStream(String fileName, String charsetName) // 将“字符 c”追加到“PrintStream 输出流中” PrintStream append(char c) // 将“字符序列从 start(包括)到 end(不包括)的全部字符”追加到“PrintStream 输出流中”
1 / 19
PrintStream PrintStream boolean
append(CharSequence charSequence, int start, int end) append(CharSequence charSequence) checkError() close()
// 将“字符序列的全部字符”追加到“PrintStream 输出流中” // flush“PrintStream 输出流缓冲中的数据”，并检查错误 // 关闭“PrintStream 输出流” synchronized void // flush“PrintStream 输出流缓冲中的数据”。 // 例如，PrintStream 装饰的是 FileOutputStream，则调用 flush 时会将数据写入到文件中 synchronized void PrintStream PrintStream void void flush() // 根据“Locale 值(区域属性)”来格式化数据 format(Locale l, String format, Object... args) format(String format, Object... args) // 根据“默认的 Locale 值(区域属性)”来格式化数据 // 将“float 数据 f 对应的字符串”写入到“PrintStream 输出流”中，print 实际调用的是 write 函数 print(float f) print(double d) print(String str) // 将“double 数据 d 对应的字符串”写入到“PrintStream 输出流”中，print 实际调用的是 write 函数 // 将“字符串数据 str”写入到“PrintStream 输出流”中，print 实际调用的是 write 函数 synchronized void void void void void void void // 将“对象 o 对应的字符串”写入到“PrintStream 输出流”中，print 实际调用的是 write 函数 print(Object o) print(char c) print(char[] chars) print(long l) print(int i) print(boolean b) printf(Locale l, String format, Object... args) printf(String format, Object... args) // 将“字符 c 对应的字符串”写入到“PrintStream 输出流”中，print 实际调用的是 write 函数 // 将“字符数组 chars 对应的字符串”写入到“PrintStream 输出流”中，print 实际调用的是 write 函数 // 将“long 型数据 l 对应的字符串”写入到“PrintStream 输出流”中，print 实际调用的是 write 函数 // 将“int 数据 i 对应的字符串”写入到“PrintStream 输出流”中，print 实际调用的是 write 函数 // 将“boolean 数据 b 对应的字符串”写入到“PrintStream 输出流”中，print 实际调用的是 write 函数 // 将“数据 args”根据“Locale 值(区域属性)”按照 format 格式化，并写入到“PrintStream 输出流”中 PrintStream PrintStream void void // 将“数据 args”根据“默认 Locale 值(区域属性)”按照 format 格式化，并写入到“PrintStream 输出流”中 // 将“换行符”写入到“PrintStream 输出流”中，println 实际调用的是 write 函数 println() println(float f) // 将“float 数据对应的字符串+换行符”写入到“PrintStream 输出流”中，println 实际调用的是 write 函数 // 将“int 数据对应的字符串+换行符”写入到“PrintStream 输出流”中，println 实际调用的是 write 函数 2 / 19