Java.io.Reader.read() Method

Description

The java.io.Reader.read() method reads a single character. This method will block until a character is available, an I/O error occurs, or the end of the stream is reached.

Declaration

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

public int read()

Parameters

• NA

Return Value

This method returns the character read, as an integer in the range 0 to 65535 (0x00-0xffff), or -1 if the end of the stream has been reached

Exception

• IOException -- If the stream does not support mark(), or if some other I/O error occurs

Example

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

package com.tutorialspoint;

import java.io.*;

public class ReaderDemo {

   public static void main(String[] args) {

      String s = "Hello World";

      // create a new StringReader
      Reader reader = new StringReader(s);

      try {
         // read the first five chars
         for (int i = 0; i < 5; i++) {
            char c = (char) reader.read();
            System.out.print("" + c);
         }

         // change line
         System.out.println();

         // close the stream
         reader.close();

      } catch (IOException ex) {
         ex.printStackTrace();
      }
   }
}

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

Hello