java.io.InputStream.read(byte[] b, int off, int len) 方法從輸入流讀取轉換為字節數組數據達到len個字節。如果參數len為0，則讀取任何字節並返回0;否則有嘗試讀取至少一個字節。如果該流是在該文件的末尾，則返回的值為-1。

聲明

以下是java.io.InputStream.read(byte[] b, int off, int len) 方法的聲明：

public int read(byte[] b, int off, int len)

參數

• b -- 目標字節數組。

• off -- 在數組b在其中寫入數據的起始位置的偏移。

• len -- 要讀取的字節數。

返回值

該方法返回讀入緩衝區的總字節數，或如果冇有更多的數據，因為數據流的末尾已到達返回-1。

異常

• IOException -- 如果發生I/ O錯誤。

• NullPointerException -- 如果b為 null.

• IndexOutOfBoundsException -- 如果off為負，len為負，或len大於b.length - off。

例子

下麵的例子顯示java.io.InputStream.read(byte[] b, int off, int len)方法用法。

package com.yiibai;

import java.io.FileInputStream;
import java.io.InputStream;

public class InputStreamDemo {
   public static void main(String[] args) throws Exception {
      
      InputStream is = null;
      byte[] buffer=new byte[5];
      char c;
      
      try{
         // new input stream created
         is = new FileInputStream("C://test.txt");
         
         System.out.println("Characters printed:");
         
         // read stream data into buffer
         is.read(buffer, 2, 3);
         
         // for each byte in the buffer
         for(byte b:buffer)
         {
            // convert byte to character
            if(b==0)
               
               // if b is empty
               c='-';
            else
               
               // if b is read
               c=(char)b;
            
            // prints character
            System.out.print(c);
         }
      }catch(Exception e){
         
         // if any I/O error occurs
         e.printStackTrace();
      }finally{
         
         // releases system resources associated with this stream
         if(is!=null)
            is.close();
      }
   }
}

假設我們有一個文本文件c:/ test.txt，它具有以下內容。該文件將被用作輸入到我們的示例程序：

ABCDE

讓我們來編譯和運行上麵的程序，這將產生以下結果：

Characters printed:
--ABC