Open In App

DataInputStream readFully() method in Java with Examples

Improve
Improve
Like Article
Like
Save
Share
Report

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)



Last Updated : 05 Jun, 2020
Like Article
Save Article
Previous
Next
Share your thoughts in the comments
Similar Reads