Java.io.InputStream Class in Java

01 Mar, 2018
InputStream class is the superclass of all the io classes i.e. representing an input stream of bytes. It represents input stream of bytes. Applications that are defining subclass of InputStream must provide method, returning the next byte of input.A reset() method is invoked which re-positions the stream to the recently marked position.Declaration :
public abstract class InputStream
   extends Object
      implements Closeable
Constructor :
InputStream() : Single Constructor
Methods:
mark() : Java.io.InputStream.mark(int arg) marks the current position of the input stream. It sets readlimit i.e. maximum number of bytes that can be read before mark position becomes invalid.Syntax :public void mark(int arg)
Parameters :
arg : integer specifying the read limit of the input Stream
Return : 
void
public void mark(int arg)
Parameters :
arg : integer specifying the read limit of the input Stream
Return : 
void
read() : java.io.InputStream.read() reads next byte of data from the Input Stream. The value byte is returned in the range 0 to 255. If no byte is available because the end of the stream has been reached, the value -1 is returned.Syntax :public abstract int read()
Parameters :
------
Return : 
Reads next data else, -1 i.e. when end of file is reached.
Exception :
->  IOException : If I/O error occurs.
public abstract int read()
Parameters :
------
Return : 
Reads next data else, -1 i.e. when end of file is reached.
Exception :
->  IOException : If I/O error occurs.
close() : java.io.InputStream.close() closes the input stream and releases system resources associated with this stream to Garbage Collector.Syntax :public void close()
Parameters :
------
Return : 
void
Exception :
->  IOException : If I/O error occurs.
public void close()
Parameters :
------
Return : 
void
Exception :
->  IOException : If I/O error occurs.
read() : Java.io.InputStream.read(byte[] arg) reads number of bytes of arg.length from the input stream to the buffer array arg. The bytes read by read() method are returned as int. If len is zero, then no bytes are read and 0 is returned; otherwise, there is an attempt to read at least one byte.Syntax :public int read(byte[] arg)
Parameters :
arg : array whose number of bytes to be read
Return : 
 reads number of bytes and return to the buffer else, -1 i.e. when end of file is reached.
Exception :
->  IOException : If I/O error occurs.
->  NullPointerException : if arg is null.
public int read(byte[] arg)
Parameters :
arg : array whose number of bytes to be read
Return : 
 reads number of bytes and return to the buffer else, -1 i.e. when end of file is reached.
Exception :
->  IOException : If I/O error occurs.
->  NullPointerException : if arg is null.
reset() : Java.io.InputStream.reset() is invoked by mark() method. It repositions the input stream to the marked position.Syntax :public void reset()
Parameters :
----
Return : 
void
Exception :
->  IOException : If I/O error occurs.
public void reset()
Parameters :
----
Return : 
void
Exception :
->  IOException : If I/O error occurs.
markSupported() : Java.io.InputStream.markSupported() method tests if this input stream supports the mark and reset methods. The markSupported method of InputStream returns false by default.Syntax :public boolean markSupported()
Parameters :
-------
Return : 
true if input stream supports the mark() and reset() method  else,false
public boolean markSupported()
Parameters :
-------
Return : 
true if input stream supports the mark() and reset() method  else,false
skip() : Java.io.InputStream.skip(long arg) skips and discards arg bytes in the input stream.Syntax :public long skip(long arg)
Parameters :
arg : no. of bytes to be skipped
Return : 
skip bytes.
Exception :
->  IOException : If I/O error occurs.
public long skip(long arg)
Parameters :
arg : no. of bytes to be skipped
Return : 
skip bytes.
Exception :
->  IOException : If I/O error occurs.
Java Program explaining InputStream Class methods :
// Java program illustrating the working of InputStream method// mark(), read(), skip()// markSupported(), close(), reset()import java.io.*;  public class NewClass{    public static void main(String[] args) throws Exception    {        InputStream geek = null;        try {              geek = new FileInputStream("ABC.txt");              // read() method : reading and printing Characters            // one by one            System.out.println("Char : "+(char)geek.read());            System.out.println("Char : "+(char)geek.read());            System.out.println("Char : "+(char)geek.read());              // mark() : read limiing the 'geek' input stream            geek.mark(0);              // skip() : it results in redaing of 'e' in G'e'eeks            geek.skip(1);            System.out.println("skip() method comes to play");            System.out.println("mark() method comes to play");            System.out.println("Char : "+(char)geek.read());            System.out.println("Char : "+(char)geek.read());            System.out.println("Char : "+(char)geek.read());              boolean check = geek.markSupported();            if (geek.markSupported())            {                // reset() method : repositioning the stram to                // marked positions.                geek.reset();                System.out.println("reset() invoked");                System.out.println("Char : "+(char)geek.read());                System.out.println("Char : "+(char)geek.read());            }            else                System.out.println("reset() method not supported.");                System.out.println("geek.markSupported() supported"+                              " reset() : "+check);          }        catch(Exception excpt)        {            // in case of I/O error            excpt.printStackTrace();        }        finally        {            // releasing the resources back to the            // GarbageCollector when closes            if (geek!=null)            {                // Use of close() : closing the file                // and releasing resources                geek.close();            }        }    }}
Note :This code won’t run on online IDE as no suc file is present here.You can run this code on your System to check the working.ABC.txt file used in the code has
HelloGeeks
Output :
Char : H
Char : e
Char : l
skip() method comes to play
mark() method comes to play
Char : o
Char : G
Char : e
reset() method not supported.
geek.markSupported() supported reset() : false
This article is contributed by Mohit Gupta . If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.
Please write comments if you find anything incorrect, or you want to share more information about the topic discussed above.
Java-I/O
java-stream
Java
Java
Writing code in comment?
Please use ide.geeksforgeeks.org,
generate link and share the link here.