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