DataInputStream.Read 方法

[Android.Runtime.Register("read", "([B)I", "")]
public override sealed int Read(byte[]? b);

[<Android.Runtime.Register("read", "([B)I", "")>]
override this.Read : byte[] -> int

參數

傳回

讀取到緩衝區的總位元組數，或 -1 是當資料已到達串流末端時，資料已無餘量。

屬性

RegisterAttribute

例外狀況

備註

從包含的輸入串流讀取一定數量的位元組，並將其儲存到緩衝陣列 b中。 實際讀取的位元組數以整數形式回傳。 此方法會阻塞直到輸入資料可用、檔案結束或拋出例外為止。

若 b 為空，則拋出 a NullPointerException 。 若 的 b 長度為零，則不會讀取位元組並 0 回傳;否則嘗試讀取至少一個位元組。 若串流位於檔案末尾，無法使用位元組，則返回該值 -1 ;否則，至少會讀取一個位元組並儲存在 b。

第一個位元組讀取會儲存在元素 b[0]中，下一個位元組則儲存在 b[1]元素中，依此類推。 讀取的位元組數最多等於 的 b長度。 設k為實際讀取的位元組數;這些位元組會被儲存在b[0]元素中b[k-1]，透過 的元素則不b[k]b[b.length-1]受影響。

此 read(b) 方法的效果與： <blockquote 同理>

read(b, 0, b.length)

</區塊引用>

Java 文件 java.io.DataInputStream.read(byte[])。

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

[Android.Runtime.Register("read", "([BII)I", "")]
public override sealed int Read(byte[]? b, int off, int len);

[<Android.Runtime.Register("read", "([BII)I", "")>]
override this.Read : byte[] * int * int -> int

參數

傳回

讀取到緩衝區的總位元組數，或 -1 是當資料已到達串流末端時，資料已無餘量。

屬性

RegisterAttribute

例外狀況

備註

從包含的輸入串流中讀取最多位 len 元組的資料，並組成一個位元組陣列。 嘗試讀取最多位 len 元組，但可讀取的數量較少，可能是零。 實際讀取的位元組數以整數形式回傳。

此方法會阻塞直到輸入資料可用、檔案結束或拋出例外為止。

若 len 為零，則不會讀取位元組並 0 回傳;否則嘗試讀取至少一個位元組。 若串流位於檔案末尾，無法使用位元組，則返回該值 -1 ;否則，至少會讀取一個位元組並儲存在 b。

第一個位元組讀取會儲存在元素 b[off]中，下一個位元組則儲存在 b[off+1]元素中，依此類推。 讀取 len的位元組數最多等於 。 設 k 為實際讀取的位元組數;這些位元組會以元素儲存在 b[off+k-1] 以內的元素b[off]中，而 k] 以內b[off+len-1]的元素b[off+則不受影響。

在每種情況下，b[0]元素通過b[off]b[off+len]和元素b[b.length-1]都不受影響。

Java 文件 java.io.DataInputStream.read(byte[], int, int)。

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