語言

BufferedReader.Read(Char[], Int32, Int32) 方法

定義

將字元讀入陣列的一部分。

[Android.Runtime.Register("read", "([CII)I", "GetRead_arrayCIIHandler")]
public override int Read(char[]? cbuf, int off, int len);
[<Android.Runtime.Register("read", "([CII)I", "GetRead_arrayCIIHandler")>]
override this.Read : char[] * int * int -> int

參數

cbuf
Char[]

目的緩衝區

off
Int32

開始儲存角色的偏移

len
Int32

最大可讀取字元數

傳回

讀取字元數,若已到達串流結束則為 -1

屬性

例外狀況

如果 offset buffer.length。

如果讀取器關閉或發生其他輸入輸出錯誤。

備註

將字元讀入陣列的一部分。

此方法實作該類別對應 {@link Reader#read(char[], int, int) read} 方法 {@link Reader} 的一般契約。 為了方便,它會嘗試透過反覆呼叫 read 底層串流的方法來讀取盡可能多的字元。 此循環 read 持續,直到以下條件之一成立為止: <ul>

<已> 讀出指定字數,

<li>read 底層串流的方法回傳 -1,表示檔案結束,或

<li> 底 ready 層串流的方法回傳 false,表示進一步的輸入請求會被阻塞。

</ul> 如果底層串流中第一個read-1返回以表示檔案結束,則此方法回傳 -1。 否則,此方法會回傳實際讀取的字元數。

此類別的子職業被鼓勵但非強制,嘗試以相同方式閱讀盡可能多的字元。

通常此方法會從該串流的字元緩衝區取字元,並根據需要從底層串流填充。 然而,如果緩衝區為空、標記無效,且請求長度至少與緩衝區一樣大,則此方法將直接從底層串流讀取字元到給定陣列。 因此,冗餘 BufferedReader的 s 不會不必要地複製資料。

Java 文件 java.io.BufferedReader.read(char[], int, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於