鴻蒙OS PushbackReader

2022-10-25 11:31 更新

PushbackReader

java.lang.Object

|---java.io.Reader

|---|---java.io.FilterReader

|---|---|---java.io.PushbackReader

public class PushbackReader
extends FilterReader

一個(gè)字符流閱讀器,允許將字符推回流中。

Since:

JDK1.1

字段摘要

從類 java.io.FilterReader 繼承的字段
in
從類 java.io.Reader 繼承的字段
lock

構(gòu)造函數(shù)總結(jié)

構(gòu)造函數(shù) 描述
PushbackReader(Reader in) 創(chuàng)建一個(gè)具有單字符回送緩沖區(qū)的新回送閱讀器。
PushbackReader(Reader in, int size) 使用給定大小的回推緩沖區(qū)創(chuàng)建一個(gè)新的回推閱讀器。

方法總結(jié)

修飾符和類型 方法 描述
void close() 關(guān)閉流并釋放與其關(guān)聯(lián)的任何系統(tǒng)資源。
void mark(int readAheadLimit) 標(biāo)記流中的當(dāng)前位置。
boolean markSupported() 告知此流是否支持 mark() 操作,但它不支持。
int read() 讀取單個(gè)字符。
int read(char[] cbuf, int off, int len) 將字符讀入數(shù)組的一部分。
boolean ready() 告訴這個(gè)流是否準(zhǔn)備好被讀取。
void reset() 重置流。
long skip(long n) 跳過字符。
void unread(char[] cbuf) 通過將字符數(shù)組復(fù)制到推回緩沖區(qū)的前面來推回它。
void unread(char[] cbuf, int off, int len) 通過將字符數(shù)組的一部分復(fù)制到推回緩沖區(qū)的前面來推回它。
void unread(int c) 通過將單個(gè)字符復(fù)制到推回緩沖區(qū)的前面來推回單個(gè)字符。
從類 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
從類 java.io.Reader 繼承的方法
read, read

構(gòu)造函數(shù)詳細(xì)信息

PushbackReader

public PushbackReader(Reader in, int size)

使用給定大小的回推緩沖區(qū)創(chuàng)建一個(gè)新的回推閱讀器。

參數(shù):

參數(shù)名稱 參數(shù)描述
in 從中讀取字符的閱讀器
size 推回緩沖區(qū)的大小

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果 size <= 0

PushbackReader

public PushbackReader(Reader in)

創(chuàng)建一個(gè)具有單字符回送緩沖區(qū)的新回送閱讀器。

參數(shù):

參數(shù)名稱 參數(shù)描述
in 從中讀取字符的閱讀器

方法詳情

read

public int read() throws IOException

讀取單個(gè)字符。

覆蓋:

在類 FilterReader 中讀取

返回:

讀取的字符,如果已到達(dá)流的末尾,則為 -1

Throws:

Throw名稱 Throw描述
IOException 如果發(fā)生 I/O 錯(cuò)誤

read

public int read(char[] cbuf, int off, int len) throws IOException

將字符讀入數(shù)組的一部分。

覆蓋:

在類 FilterReader 中讀取

參數(shù):

參數(shù)名稱 參數(shù)描述
cbuf 目標(biāo)緩沖區(qū)
off 開始寫入字符的偏移量
len 要讀取的最大字符數(shù)

返回:

讀取的字符數(shù),如果已到達(dá)流的末尾,則為 -1

Throws:

Throw名稱 Throw描述
IOException 如果發(fā)生 I/O 錯(cuò)誤

unread

public void unread(int c) throws IOException

通過將單個(gè)字符復(fù)制到推回緩沖區(qū)的前面來推回單個(gè)字符。 此方法返回后,下一個(gè)要讀取的字符將具有值 (char)c。

參數(shù):

參數(shù)名稱 參數(shù)描述
c 表示要推回的字符的 int 值

Throws:

Throw名稱 Throw描述
IOException 如果推回緩沖區(qū)已滿,或者發(fā)生其他 I/O 錯(cuò)誤

unread

public void unread(char[] cbuf, int off, int len) throws IOException

通過將字符數(shù)組的一部分復(fù)制到推回緩沖區(qū)的前面來推回它。 此方法返回后,下一個(gè)要讀取的字符將具有值 cbuf[off],之后的字符將具有值 cbuf[off+1],依此類推。

參數(shù):

參數(shù)名稱 參數(shù)描述
cbuf 字符數(shù)組
off 要推回的第一個(gè)字符的偏移量
len 要推回的字符數(shù)

Throws:

Throw名稱 Throw描述
IOException 如果推回緩沖區(qū)中沒有足夠的空間,或者發(fā)生其他一些 I/O 錯(cuò)誤

unread

public void unread(char[] cbuf) throws IOException

通過將字符數(shù)組復(fù)制到推回緩沖區(qū)的前面來推回它。 此方法返回后,要讀取的下一個(gè)字符將具有值 cbuf[0],之后的字符將具有值 cbuf[1],依此類推。

參數(shù):

參數(shù)名稱 參數(shù)描述
cbuf 要推回的字符數(shù)組

Throws:

Throw名稱 Throw描述
IOException 如果推回緩沖區(qū)中沒有足夠的空間,或者發(fā)生其他一些 I/O 錯(cuò)誤

ready

public boolean ready() throws IOException

告訴這個(gè)流是否準(zhǔn)備好被讀取。

覆蓋:

在類 FilterReader 中準(zhǔn)備好

返回:

如果保證下一個(gè) read() 不會(huì)阻塞輸入,則為 true,否則為 false。 請(qǐng)注意,返回 false 并不能保證下一次讀取將阻塞。

Throws:

Throw名稱 Throw描述
IOException 如果發(fā)生 I/O 錯(cuò)誤

mark

public void mark(int readAheadLimit) throws IOException

標(biāo)記流中的當(dāng)前位置。 PushbackReader 類的標(biāo)記總是拋出異常。

覆蓋:

在類 FilterReader 中標(biāo)記

參數(shù):

參數(shù)名稱 參數(shù)描述
readAheadLimit 在保留標(biāo)記的同時(shí)限制可以讀取的字符數(shù)。 讀取這么多字符后,嘗試重置流可能會(huì)失敗。

Throws:

Throw名稱 Throw描述
IOException 總是,因?yàn)椴恢С謽?biāo)記

reset

public void reset() throws IOException

重置流。 PushbackReader 的 reset 方法總是拋出異常。

覆蓋:

在類 FilterReader 中重置

Throws:

Throw名稱 Throw描述
IOException 總是,因?yàn)椴恢С种刂?/td>

markSupported

public boolean markSupported()

告知此流是否支持 mark() 操作,但它不支持。

覆蓋:

類 FilterReader 中的 markSupported

返回:

當(dāng)且僅當(dāng)此流支持標(biāo)記操作時(shí)才為 true。

close

public void close() throws IOException

關(guān)閉流并釋放與其關(guān)聯(lián)的任何系統(tǒng)資源。 流關(guān)閉后,進(jìn)一步的 read()、unread()、ready() 或 skip() 調(diào)用將引發(fā) IOException。 關(guān)閉以前關(guān)閉的流沒有效果。

指定者:

在接口 AutoCloseable 中關(guān)閉

指定者:

在接口Closeable中關(guān)閉

覆蓋:

在類 FilterReader 中關(guān)閉

Throws:

Throw名稱 Throw描述
IOException 如果發(fā)生 I/O 錯(cuò)誤

skip

public long skip(long n) throws IOException

跳過字符。 此方法將阻塞,直到某些字符可用、發(fā)生 I/O 錯(cuò)誤或到達(dá)流的末尾。

覆蓋:

跳過類 FilterReader

參數(shù):

參數(shù)名稱 參數(shù)描述
n 要跳過的字符數(shù)

返回:

實(shí)際跳過的字符數(shù)

Throws:

Throw名稱 Throw模式
IllegalArgumentException 如果 n 為負(fù)數(shù)。
IOException 如果發(fā)生 I/O 錯(cuò)誤
以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)