Related Articles

Related Articles

DataInputStream readFully() method in Java with Examples
  • Last Updated : 05 Jun, 2020

The readFully() method of DataInputStream class in Java is of two types:

  1. readFully(byte[] b) method of DataInputStream class in Java is used to read bytes equal to the length of byte array b from an input stream and store them into the byte array b.

    General Contract:
    The readFully(byte[] b) method is blocked in case of one of the following conditions:

    • Input data is available and it returns normal.
    • File is ended and an EOFException is thrown.
    • An I/O error occurs and an IOException is thrown.

    Syntax:

    public final void readFully(byte[] b)
                      throws IOException
    

    Specified By: This method is specified by the readFully() method of DataInput interface.

    Parameters: This method accepts one parameter b which represents the byte array into which the data is to be read.



    Return value: This method does not return any value.

    Exceptions:

    • NullPointerException – It throws NullPointerException if byte array is null.
    • EOFException – It throws EOFException if the file is ended.
    • IOException – This method throws IOException if the stream is closed or some other I/O error occurs.

    Below program illustrates readFully(byte[]) method in DataInputStream class in IO package:

    Program: Assume the existence of file “c:/demo.txt”.




    // Java program to illustrate
    // DataInputStream readFully(byte[]) method
    import java.io.*;
    public class GFG {
        public static void main(String[] args)
            throws IOException
        {
      
            // Create input stream 'demo.txt'
            // for reading containing
            // text "GEEKSFORGEEKS"
            FileInputStream inputStream
                = new FileInputStream(
                    "c:/demo.txt");
      
            // Convert inputStream to
            // DataInputStream
            DataInputStream dataInputStr
                = new DataInputStream(
                    inputStream);
      
            // Count the total bytes
            int count = dataInputStr.available();
      
            // Create byte array
            byte[] b = new byte[count];
      
            // Read full data into byte array
            dataInputStr.readFully(b);
      
            for (byte by : b) {
                // Print the character
                System.out.print((char)by);
            }
        }
    }

    
    

    Input:
    Output:
  2. readFully(byte[] b, int offset, int length) method of DataInputStream class in Java is used to read bytes equal to the parameter passed ‘length’ from an input stream and store them into the byte array b.

    General Contract:
    The readFully(byte[], int, int) method is blocked in case of one of the following conditions:

    • Input data is available and it returns normal.
    • File is ended and an EOFException is thrown.
    • An I/O error occurs and an IOException is thrown.

    Syntax:

    public final void readFully(byte[] b,
                                int offset,
                                int length)
                         throws IOException
    

    Specified By: This method is specified by the readFully() method of DataInput interface.

    Parameters: This method accepts three parameters:

    • b – It represents the byte array into which the data is to read.
    • offset – It represents the starting index in the byte array.
    • length – It represents the total number of bytes to be read.

    Return value: This method does not return any value.

    Exceptions:

    • NullPointerException – It throws NullPointerException if byte array is null.
    • IndexOutOfBoundsException – It throws IndexOutOfBoundsException if offset is negative or length is negative or length is greater than the difference of length of byte array and offset.
    • EOFException – It throws EOFException if the file is ended.
    • IOException – This method throws IOException if the stream is closed or some other I/O error occurs.

    Below program illustrates readFully(byte[], int, int) method in DataInputStream class in IO package:

    Program: Assume the existence of file “c:/demo.txt”.




    // Java program to illustrate
    // DataInputStream readFully(byte[], int, int) method
    import java.io.*;
    public class GFG {
        public static void main(String[] args)
            throws IOException
        {
      
            // Create input stream 'demo.txt'
            // for reading containing
            // text "GEEKSFORGEEKS"
            FileInputStream inputStream
                = new FileInputStream(
                    "c:/demo.txt");
      
            // Convert inputStream to
            // DataInputStream
            DataInputStream dataInputStr
                = new DataInputStream(
                    inputStream);
      
            // Count the total bytes
            int count = dataInputStr.available();
      
            // Create byte array
            byte[] b = new byte[count];
      
            // Read full data into byte array
            dataInputStr.readFully(b, 4, 5);
      
            for (byte by : b) {
                // Print the character
                System.out.print((char)by);
            }
        }
    }

    
    

    Input:
    Output:

References:
1. https://docs.oracle.com/javase/10/docs/api/java/io/DataInputStream.html#readFully(byte%5B%5D)
2. https://docs.oracle.com/javase/10/docs/api/java/io/DataInputStream.html#readFully(byte%5B%5D, int, int)

Attention reader! Don’t stop learning now. Get hold of all the important Java Foundation and Collections concepts with the Fundamentals of Java and Java Collections Course at a student-friendly price and become industry ready.




My Personal Notes arrow_drop_up
Recommended Articles
Page :