PrintWriter 介绍
PrintWriter 是字符类型的打印输出流，它继承于Writer。
PrintStream 用于向文本输出流打印对象的格式化表示形式。它实现在 PrintStream 中的所有 print 方法。它不包含用于写入原始字节的方法，对于这些字节，程序应该使用未编码的字节流进行写入。
PrintWriter 函数列表
|
1
2
3
4
5
6
7
8
9
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
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
|
PrintWriter(OutputStream out)PrintWriter(OutputStream out, boolean autoFlush)PrintWriter(Writer wr)PrintWriter(Writer wr, boolean autoFlush)PrintWriter(File file)PrintWriter(File file, String csn)PrintWriter(String fileName)PrintWriter(String fileName, String csn)PrintWriter append(char c)PrintWriter append(CharSequence csq, int start, int end)PrintWriter append(CharSequence csq)boolean checkError()void close()void flush()PrintWriter format(Locale l, String format, Object... args)PrintWriter format(String format, Object... args)void print(float fnum)void print(double dnum)void print(String str)void print(Object obj)void print(char ch)void print(char[] charArray)void print(long lnum)void print(int inum)void print(boolean bool)PrintWriter printf(Locale l, String format, Object... args)PrintWriter printf(String format, Object... args)void println()void println(float f)void println(int i)void println(long l)void println(Object obj)void println(char[] chars)void println(String str)void println(char c)void println(double d)void println(boolean b)void write(char[] buf, int offset, int count)void write(int oneChar)void write(char[] buf)void write(String str, int offset, int count)void write(String str) PrintWriter 源码 package java.io; import java.util.Objects; import java.util.Formatter; import java.util.Locale; import java.nio.charset.Charset; import java.nio.charset.IllegalCharsetNameException; import java.nio.charset.UnsupportedCharsetException; public class PrintWriter extends Writer { protected Writer out; // 自动flush // 所谓“自动flush”，就是每次执行print(), println(), write()函数，都会调用flush()函数； // 而“不自动flush”，则需要我们手动调用flush()接口。 private final boolean autoFlush; // PrintWriter是否右产生异常。当PrintWriter有异常产生时，会被本身捕获，并设置trouble为true private boolean trouble = false; // 用于格式化的对象 private Formatter formatter; private PrintStream psOut = null; // 行分割符 private final String lineSeparator; // 获取csn(字符集名字)对应的Chaset private static Charset toCharset(String csn) throws UnsupportedEncodingException { Objects.requireNonNull(csn, "charsetName"); try { return Charset.forName(csn); } catch (IllegalCharsetNameException|UnsupportedCharsetException unused) { // UnsupportedEncodingException should be thrown throw new UnsupportedEncodingException(csn); } } // 将“Writer对象out”作为PrintWriter的输出流，默认不会自动flush，并且采用默认字符集。 public PrintWriter (Writer out) { this(out, false); } // 将“Writer对象out”作为PrintWriter的输出流，autoFlush的flush模式，并且采用默认字符集。 public PrintWriter(Writer out, boolean autoFlush) { super(out); this.out = out; this.autoFlush = autoFlush; lineSeparator = java.security.AccessController.doPrivileged( new sun.security.action.GetPropertyAction("line.separator")); } // 将“输出流对象out”作为PrintWriter的输出流，不自动flush，并且采用默认字符集。 public PrintWriter(OutputStream out) { this(out, false); } // 将“输出流对象out”作为PrintWriter的输出流，autoFlush的flush模式，并且采用默认字符集。 public PrintWriter(OutputStream out, boolean autoFlush) { // new OutputStreamWriter(out)：将“字节类型的输出流”转换为“字符类型的输出流” // new BufferedWriter(...): 为输出流提供缓冲功能。 this(new BufferedWriter(new OutputStreamWriter(out)), autoFlush); // save print stream for error propagation if (out instanceof java.io.PrintStream) { psOut = (PrintStream) out; } } // 创建fileName对应的OutputStreamWriter，进而创建BufferedWriter对象；然后将该BufferedWriter作为PrintWriter的输出流，不自动flush，采用默认字符集。 public PrintWriter(String fileName) throws FileNotFoundException { this(new BufferedWriter(new OutputStreamWriter(new FileOutputStream(fileName))), false); } // 创建fileName对应的OutputStreamWriter，进而创建BufferedWriter对象；然后将该BufferedWriter作为PrintWriter的输出流，不自动flush，采用字符集charset。 private PrintWriter(Charset charset, File file) throws FileNotFoundException { this(new BufferedWriter(new OutputStreamWriter(new FileOutputStream(file), charset)), false); } // 创建fileName对应的OutputStreamWriter，进而创建BufferedWriter对象；然后将该BufferedWriter作为PrintWriter的输出流，不自动flush，采用csn字符集。 public PrintWriter(String fileName, String csn) throws FileNotFoundException, UnsupportedEncodingException { this(toCharset(csn), new File(fileName)); } // 创建file对应的OutputStreamWriter，进而创建BufferedWriter对象；然后将该BufferedWriter作为PrintWriter的输出流，不自动flush，采用默认字符集。 public PrintWriter(File file) throws FileNotFoundException { this(new BufferedWriter(new OutputStreamWriter(new FileOutputStream(file))), false); } // 创建file对应的OutputStreamWriter，进而创建BufferedWriter对象；然后将该BufferedWriter作为PrintWriter的输出流，不自动flush，采用csn字符集。 public PrintWriter(File file, String csn) throws FileNotFoundException, UnsupportedEncodingException { this(toCharset(csn), file); } private void ensureOpen() throws IOException { if (out == null) throw new IOException("Stream closed"); } // flush“PrintWriter输出流中的数据”。 public void flush() { try { synchronized (lock) { ensureOpen(); out.flush(); } } catch (IOException x) { trouble = true; } } public void close() { try { synchronized (lock) { if (out == null) return; out.close(); out = null; } } catch (IOException x) { trouble = true; } } // flush“PrintWriter输出流缓冲中的数据”，并检查错误 public boolean checkError() { if (out != null) { flush(); } if (out instanceof java.io.PrintWriter) { PrintWriter pw = (PrintWriter) out; return pw.checkError(); } else if (psOut != null) { return psOut.checkError(); } return trouble; } protected void setError() { trouble = true; } protected void clearError() { trouble = false; } // 将字符c写入到“PrintWriter输出流”中。c虽然是int类型，但实际只会写入一个字符 public void write(int c) { try { synchronized (lock) { ensureOpen(); out.write(c); } } catch (InterruptedIOException x) { Thread.currentThread().interrupt(); } catch (IOException x) { trouble = true; } } // 将“buf中从off开始的len个字符”写入到“PrintWriter输出流”中。 public void write(char buf[], int off, int len) { try { synchronized (lock) { ensureOpen(); out.write(buf, off, len); } } catch (InterruptedIOException x) { Thread.currentThread().interrupt(); } catch (IOException x) { trouble = true; } } // 将“buf中的全部数据”写入到“PrintWriter输出流”中。 public void write(char buf[]) { write(buf, , buf.length); } // 将“字符串s中从off开始的len个字符”写入到“PrintWriter输出流”中。 public void write(String s, int off, int len) { try { synchronized (lock) { ensureOpen(); out.write(s, off, len); } } catch (InterruptedIOException x) { Thread.currentThread().interrupt(); } catch (IOException x) { trouble = true; } } // 将“字符串s”写入到“PrintWriter输出流”中。 public void write(String s) { write(s, , s.length()); } // 将“换行符”写入到“PrintWriter输出流”中。 private void newLine() { try { synchronized (lock) { ensureOpen(); out.write(lineSeparator); if (autoFlush) out.flush(); } } catch (InterruptedIOException x) { Thread.currentThread().interrupt(); } catch (IOException x) { trouble = true; } } // 将“boolean数据对应的字符串”写入到“PrintWriter输出流”中，print实际调用的是write函数 public void print(boolean b) { write(b ? "true" : "false"); } // 将“字符c对应的字符串”写入到“PrintWriter输出流”中，print实际调用的是write函数 public void print(char c) { write(c); } // 将“int数据i对应的字符串”写入到“PrintWriter输出流”中，print实际调用的是write函数 public void print(int i) { write(String.valueOf(i)); } // 将“long型数据l对应的字符串”写入到“PrintWriter输出流”中，print实际调用的是write函数 public void print(long l) { write(String.valueOf(l)); } // 将“float数据f对应的字符串”写入到“PrintWriter输出流”中，print实际调用的是write函数 public void print(float f) { write(String.valueOf(f)); } // 将“double数据d对应的字符串”写入到“PrintWriter输出流”中，print实际调用的是write函数 public void print(double d) { write(String.valueOf(d)); } // 将“字符数组s”写入到“PrintWriter输出流”中，print实际调用的是write函数 public void print(char s[]) { write(s); } // 将“字符串数据s”写入到“PrintWriter输出流”中，print实际调用的是write函数 public void print(String s) { if (s == null) { s = "null"; } write(s); } // 将“对象obj对应的字符串”写入到“PrintWriter输出流”中，print实际调用的是write函数 public void print(Object obj) { write(String.valueOf(obj)); } // 将“换行符”写入到“PrintWriter输出流”中，println实际调用的是write函数 public void println() { newLine(); } // 将“boolean数据对应的字符串+换行符”写入到“PrintWriter输出流”中，println实际调用的是write函数 public void println(boolean x) { synchronized (lock) { print(x); println(); } } // 将“字符x对应的字符串+换行符”写入到“PrintWriter输出流”中，println实际调用的是write函数 public void println(char x) { synchronized (lock) { print(x); println(); } } // 将“int数据对应的字符串+换行符”写入到“PrintWriter输出流”中，println实际调用的是write函数 public void println(int x) { synchronized (lock) { print(x); println(); } } // 将“long数据对应的字符串+换行符”写入到“PrintWriter输出流”中，println实际调用的是write函数 public void println(long x) { synchronized (lock) { print(x); println(); } } // 将“float数据对应的字符串+换行符”写入到“PrintWriter输出流”中，println实际调用的是write函数 public void println(float x) { synchronized (lock) { print(x); println(); } } // 将“double数据对应的字符串+换行符”写入到“PrintWriter输出流”中，println实际调用的是write函数 public void println(double x) { synchronized (lock) { print(x); println(); } } // 将“字符数组x+换行符”写入到“PrintWriter输出流”中，println实际调用的是write函数 public void println(char x[]) { synchronized (lock) { print(x); println(); } } // 将“字符串x+换行符”写入到“PrintWriter输出流”中，println实际调用的是write函数 public void println(String x) { synchronized (lock) { print(x); println(); } } // 将“对象o对应的字符串+换行符”写入到“PrintWriter输出流”中，println实际调用的是write函数 public void println(Object x) { String s = String.valueOf(x); synchronized (lock) { print(s); println(); } } // 将“数据args”根据“默认Locale值(区域属性)”按照format格式化，并写入到“PrintWriter输出流”中 public PrintWriter printf(String format, Object ... args) { return format(format, args); } // 将“数据args”根据“Locale值(区域属性)”按照format格式化，并写入到“PrintWriter输出流”中 public PrintWriter printf(Locale l, String format, Object ... args) { return format(l, format, args); } // 根据“默认的Locale值(区域属性)”来格式化数据 public PrintWriter format(String format, Object ... args) { try { synchronized (lock) { ensureOpen(); if ((formatter == null) || (formatter.locale() != Locale.getDefault())) formatter = new Formatter(this); formatter.format(Locale.getDefault(), format, args); if (autoFlush) out.flush(); } } catch (InterruptedIOException x) { Thread.currentThread().interrupt(); } catch (IOException x) { trouble = true; } return this; } // 根据“Locale值(区域属性)”来格式化数据 public PrintWriter format(Locale l, String format, Object ... args) { try { synchronized (lock) { ensureOpen(); if ((formatter == null) || (formatter.locale() != l)) formatter = new Formatter(this, l); formatter.format(l, format, args); if (autoFlush) out.flush(); } } catch (InterruptedIOException x) { Thread.currentThread().interrupt(); } catch (IOException x) { trouble = true; } return this; } // 将“字符序列的全部字符”追加到“PrintWriter输出流中” public PrintWriter append(CharSequence csq) { if (csq == null) write("null"); else write(csq.toString()); return this; } // 将“字符序列从start(包括)到end(不包括)的全部字符”追加到“PrintWriter输出流中” public PrintWriter append(CharSequence csq, int start, int end) { CharSequence cs = (csq == null ? "null" : csq); write(cs.subSequence(start, end).toString()); return this; } // 将“字符c”追加到“PrintWriter输出流中” public PrintWriter append(char c) { write(c); return this; } } |
示例代码
关于PrintWriter中API的详细用法，参考示例代码(PrintWriterTest.java)：
|
1
2
3
4
5
6
7
8
9
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
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
|
import java.io.PrintWriter; import java.io.File; import java.io.FileOutputStream; import java.io.IOException; /** * PrintWriter 的示例程序 * * */ public class PrintWriterTest { public static void main(String[] args) { // 下面个函数的作用都是一样：都是将字母“abcde”写入到文件“file.txt”中。 // 任选一个执行即可！ testPrintWriterConstrutor() ; //testPrintWriterConstrutor() ; //testPrintWriterConstrutor() ; // 测试write(), print(), println(), printf()等接口。 testPrintWriterAPIS() ; } /** * PrintWriter(OutputStream out) 的测试函数 * * 函数的作用，就是将字母“abcde”写入到文件“file.txt”中 */ private static void testPrintWriterConstrutor() { final char[] arr={'a', 'b', 'c', 'd', 'e' }; try { // 创建文件“file.txt”的File对象 File file = new File("file.txt"); // 创建文件对应FileOutputStream PrintWriter out = new PrintWriter( new FileOutputStream(file)); // 将“字节数组arr”全部写入到输出流中 out.write(arr); // 关闭输出流 out.close(); } catch (IOException e) { e.printStackTrace(); } } /** * PrintWriter(File file) 的测试函数 * * 函数的作用，就是将字母“abcde”写入到文件“file.txt”中 */ private static void testPrintWriterConstrutor() { final char[] arr={'a', 'b', 'c', 'd', 'e' }; try { File file = new File("file.txt"); PrintWriter out = new PrintWriter(file); out.write(arr); out.close(); } catch (IOException e) { e.printStackTrace(); } } /** * PrintWriter(String fileName) 的测试函数 * * 函数的作用，就是将字母“abcde”写入到文件“file.txt”中 */ private static void testPrintWriterConstrutor() { final char[] arr={'a', 'b', 'c', 'd', 'e' }; try { PrintWriter out = new PrintWriter("file.txt"); out.write(arr); out.close(); } catch (IOException e) { e.printStackTrace(); } } /** * 测试write(), print(), println(), printf()等接口。 */ private static void testPrintWriterAPIS() { final char[] arr={'a', 'b', 'c', 'd', 'e' }; try { // 创建文件对应FileOutputStream PrintWriter out = new PrintWriter("other.txt"); // 将字符串“hello PrintWriter”+回车符，写入到输出流中 out.println("hello PrintWriter"); // 将x写入到输出流中 // x对应ASCII码的字母'A'，也就是写入字符'A' out.write(x); // 将字符串""写入到输出流中。 // out.print(x); 等价于 out.write(String.valueOf(x)); out.print(x); // 将字符'B'追加到输出流中 out.append('B').append("CDEF"); // 将"CDE is " + 回车 写入到输出流中 String str = "GHI"; int num = ; out.printf("%s is %d\n", str, num); out.close(); } catch (IOException e) { e.printStackTrace(); } } } |
运行上面的代码，会在源码所在目录生成两个文件“file.txt”和“other.txt”。
file.txt的内容如下：
|
1
|
abcde |
other.txt的内容如下：
|
1
2
|
hello PrintWriterA65BCDEFGHI is 5 |
以上所述是小编给大家介绍的Java中的PrintWriter知识，希望对大家有所帮助，如果大家有任何疑问请给我留言，小编会及时回复大家的。在此也非常感谢大家对服务器之家网站的支持！
