CharArrayReader 是字符數(shù)組輸入流。它和ByteArrayInputStream類似,只不過(guò)ByteArrayInputStream是字節(jié)數(shù)組輸入流,而CharArray是字符數(shù)組輸入流。CharArrayReader 是用于讀取字符數(shù)組,它繼承于Reader。操作的數(shù)據(jù)是以字符為單位!
CharArrayReader 函數(shù)列表
1
2
3
4
5
6
7
8
9
10
|
CharArrayReader( char [] buf) CharArrayReader( char [] buf, int offset, int length) void close() void mark( int readLimit) boolean markSupported() int read() int read( char [] buffer, int offset, int len) boolean ready() void reset() long skip( long charCount) |
Reader和CharArrayReader源碼分析
Reader是CharArrayReader的父類,我們先看看Reader的源碼,然后再學(xué)CharArrayReader的源碼。
1. Reader源碼分析(基于jdk1.7.40)
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
|
package java.io; public abstract class Reader implements Readable, Closeable { protected Object lock; protected Reader() { this .lock = this ; } protected Reader(Object lock) { if (lock == null ) { throw new NullPointerException(); } this .lock = lock; } public int read(java.nio.CharBuffer target) throws IOException { int len = target.remaining(); char [] cbuf = new char [len]; int n = read(cbuf, 0 , len); if (n > 0 ) target.put(cbuf, 0 , n); return n; } public int read() throws IOException { char cb[] = new char [ 1 ]; if (read(cb, 0 , 1 ) == - 1 ) return - 1 ; else return cb[ 0 ]; } public int read( char cbuf[]) throws IOException { return read(cbuf, 0 , cbuf.length); } abstract public int read( char cbuf[], int off, int len) throws IOException; private static final int maxSkipBufferSize = 8192 ; private char skipBuffer[] = null ; public long skip( long n) throws IOException { if (n < L) throw new IllegalArgumentException( "skip value is negative" ); int nn = ( int ) Math.min(n, maxSkipBufferSize); synchronized (lock) { if ((skipBuffer == null ) || (skipBuffer.length < nn)) while (r > 0 ) { int nc = read(skipBuffer, 0 , ( int )Math.min(r, nn)); if (nc == - 1 ) break ; r -= nc; } return n - r; } } public boolean ready() throws IOException { return false ; } public boolean markSupported() { return false ; } public void mark( int readAheadLimit) throws IOException { throw new IOException( "mark() not supported" ); } public void reset() throws IOException { throw new IOException( "reset() not supported" ); } abstract public void close() throws IOException; } |
2. CharArrayReader 源碼分析(基于jdk1.7.40)
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
|
package java.io; public class CharArrayReader extends Reader { // 字符數(shù)組緩沖 protected char buf[]; // 下一個(gè)被獲取的字符的位置 protected int pos; // 被標(biāo)記的位置 protected int markedPos = 0 ; // 字符緩沖的長(zhǎng)度 protected int count; // 構(gòu)造函數(shù) public CharArrayReader( char buf[]) { this .buf = buf; this .pos = 0 ; this .count = buf.length; } // 構(gòu)造函數(shù) if ((offset < 0 ) || (offset > buf.length) || (length < 0 ) || ((offset + length) < 0 )) { throw new IllegalArgumentException(); } this .buf = buf; this .pos = offset; this .count = Math.min(offset + length, buf.length); this .markedPos = offset; } // 判斷“CharArrayReader是否有效”。 // 若字符緩沖為null,則認(rèn)為其無(wú)效。 private void ensureOpen() throws IOException { if (buf == null ) throw new IOException( "Stream closed" ); } // 讀取下一個(gè)字符。即返回字符緩沖區(qū)中下一位置的值。 // 注意:讀取的是字符! public int read() throws IOException { synchronized (lock) { ensureOpen(); if (pos >= count) return - 1 ; else return buf[pos++]; } } // 讀取數(shù)據(jù),并保存到字符數(shù)組b中從off開(kāi)始的位置中,len是讀取長(zhǎng)度。 public int read( char b[], int off, int len) throws IOException { synchronized (lock) { ensureOpen(); if ((off < 0 ) || (off > b.length) || (len < 0 ) || ((off + len) > b.length) || ((off + len) < 0 )) { throw new IndexOutOfBoundsException(); } else if (len == 0 ) { return 0 ; } if (pos >= count) { return -; } if (pos + len > count) { len = count - pos; } if (len <= 0 ) { return 0 ; } System.arraycopy(buf, pos, b, off, len); pos += len; return len; } } // 跳過(guò)n個(gè)字符 public long skip( long n) throws IOException { synchronized (lock) { ensureOpen(); if (pos + n > count) { n = count - pos; } if (n < 0 ) { return 0 ; } pos += n; return n; } } // 判斷“是否能讀取下一個(gè)字符”。能的話,返回true。 public boolean ready() throws IOException { synchronized (lock) { ensureOpen(); return (count - pos) > ; } } public boolean markSupported() { return true ; } // 保存當(dāng)前位置。readAheadLimit在此處沒(méi)有任何實(shí)際意義 // mark()必須和reset()配合使用才有意義! public void mark( int readAheadLimit) throws IOException { synchronized (lock) { ensureOpen(); markedPos = pos; } } // 重置“下一個(gè)讀取位置”為“mark所標(biāo)記的位置” public void reset() throws IOException { synchronized (lock) { ensureOpen(); pos = markedPos; } } public void close() { buf = null ; } } |
說(shuō)明:
CharArrayReader實(shí)際上是通過(guò)“字符數(shù)組”去保存數(shù)據(jù)。
(01) 通過(guò) CharArrayReader(char[] buf) 或 CharArrayReader(char[] buf, int offset, int length) ,我們可以根據(jù)buf數(shù)組來(lái)創(chuàng)建CharArrayReader對(duì)象。
(02) read()的作用是從CharArrayReader中“讀取下一個(gè)字符”。
(03) read(char[] buffer, int offset, int len)的作用是從CharArrayReader讀取字符數(shù)據(jù),并寫入到字符數(shù)組buffer中。offset是將字符寫入到buffer的起始位置,len是寫入的字符的長(zhǎng)度。
(04) markSupported()是判斷CharArrayReader是否支持“標(biāo)記功能”。它始終返回true。
(05) mark(int readlimit)的作用是記錄標(biāo)記位置。記錄標(biāo)記位置之后,某一時(shí)刻調(diào)用reset()則將“CharArrayReader下一個(gè)被讀取的位置”重置到“mark(int readlimit)所標(biāo)記的位置”;也就是說(shuō),reset()之后再讀取CharArrayReader時(shí),是從mark(int readlimit)所標(biāo)記的位置開(kāi)始讀取。
示例代碼
關(guān)于CharArrayReader中API的詳細(xì)用法,參考示例代碼(CharArrayReaderTest.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
|
/** * CharArrayReader 演示程序 * * */ import java.io.CharArrayReader; import java.io.CharArrayWriter; import java.io.IOException; public class CharArrayReaderTest { private static final int LEN = 5 ; // 對(duì)應(yīng)英文字母“abcdefghijklmnopqrstuvwxyz” private static final char [] ArrayLetters = new char [] { 'a' , 'b' , 'c' , 'd' , 'e' , 'f' , 'g' , 'h' , 'i' , 'j' , 'k' , 'l' , 'm' , 'n' , 'o' , 'p' , 'q' , 'r' , 's' , 't' , 'u' , 'v' , 'w' , 'x' , 'y' , 'z' }; public static void main(String[] args) { tesCharArrayReader() ; } /** * CharArrayReader的API測(cè)試函數(shù) */ private static void tesCharArrayReader() { try { // 創(chuàng)建CharArrayReader字符流,內(nèi)容是ArrayLetters數(shù)組 CharArrayReader car = new CharArrayReader(ArrayLetters); // 從字符數(shù)組流中讀取5個(gè)字符 for ( int i=; i<LEN; i++) { // 若能繼續(xù)讀取下一個(gè)字符,則讀取下一個(gè)字符 if (car.ready() == true ) { // 讀取“字符流的下一個(gè)字符” char tmp = ( char )car.read(); System.out.printf( "%d : %c\n" , i, tmp); } } // 若“該字符流”不支持標(biāo)記功能,則直接退出 if (!car.markSupported()) { System.out.println( "make not supported!" ); return ; } // 標(biāo)記“字符流中下一個(gè)被讀取的位置”。即--標(biāo)記“f”,因?yàn)橐驗(yàn)榍懊嬉呀?jīng)讀取了5個(gè)字符,所以下一個(gè)被讀取的位置是第6個(gè)字符” // (01), CharArrayReader類的mark(0)函數(shù)中的“參數(shù)0”是沒(méi)有實(shí)際意義的。 // (02), mark()與reset()是配套的,reset()會(huì)將“字符流中下一個(gè)被讀取的位置”重置為“mark()中所保存的位置” car.mark( 0 ); // 跳過(guò)5個(gè)字符。跳過(guò)5個(gè)字符后,字符流中下一個(gè)被讀取的值應(yīng)該是“k”。 car.skip( 5 ); // 從字符流中讀取個(gè)數(shù)據(jù)。即讀取“klmno” char [] buf = new char [LEN]; car.read(buf, 0 , LEN); System.out.printf( "buf=%s\n" , String.valueOf(buf)); // 重置“字符流”:即,將“字符流中下一個(gè)被讀取的位置”重置到“mark()所標(biāo)記的位置”,即f。 car.reset(); // 從“重置后的字符流”中讀取5個(gè)字符到buf中。即讀取“fghij” car.read(buf, 0 , LEN); System.out.printf( "buf=%s\n" , String.valueOf(buf)); } catch (IOException e) { e.printStackTrace(); } } } |
運(yùn)行結(jié)果:
1
2
3
4
5
6
7
|
0 : a 1 : b 2 : c 3 : d 4 : e buf=klmno buf=fghij |
以上所述是小編給大家介紹的Java 中的CharArrayReader知識(shí),希望對(duì)大家有所幫助,如果大家有任何疑問(wèn)請(qǐng)給我留言,小編會(huì)及時(shí)回復(fù)大家的。在此也非常感謝大家對(duì)服務(wù)器之家網(wǎng)站的支持!