Java.io.FilterInputStream.read()Method

---

---

Description

The java.io.FilterInputStream.read() method reads the next byte of the data from the input stream. The value byte returned is in the range 0 to 255. The method returns -1 if the end of the file is reached.

Declaration

Following is the declaration for java.io.FilterInputStream.read() method −

public int read()

Parameters

NA

Return Value

The method returns the next byte of data, or -1 if the end of the stream is reached.

Exception

IOException − If an I/O error occurs

Example

The following example shows the usage of java.io.FilterInputStream.read() method.

package com.tutorialspoint;

import java.io.BufferedInputStream;
import java.io.FileInputStream;
import java.io.FilterInputStream;
import java.io.IOException;
import java.io.InputStream;

public class FilterInputStreamDemo {
   public static void main(String[] args) throws Exception {
      InputStream is = null; 
      FilterInputStream fis = null; 
      int i = 0;
      char c;
      
      try {
         // create input streams
         is = new FileInputStream("C://test.txt");
         fis = new BufferedInputStream(is);
         
         // read till the end of the stream
         while((i = fis.read())!=-1) {
         
            // converts integer to character
            c = (char)i;
            
            // prints
            System.out.println("Character read: "+c);
         }
         
      } catch(IOException e) {
         // if any I/O error occurs
         e.printStackTrace();
      } finally {
         // releases any system resources associated with the stream
         if(is!=null)
            is.close();
         if(fis!=null)
            fis.close();
      }
   }
}

Assuming we have a text file c:/test.txt, which has the following content. This file will be used as an input for our example program −

ABCDEF

Let us compile and run the above program, this will produce the following result −

Character read: A
Character read: B
Character read: C
Character read: D
Character read: E
Character read: F