Java.io package Useful Resources
Java.io - Discussion

Java - DataInputStream readFully() method

Description

The Java DataInputStream readFully(byte[] b, int off, int len) method reads len bytes from an input stream.

It blocks until the one of the below conditions occurs −

b.length bytes of input data are available.
End of file detected.
If any I/O error occurs.

Declaration

Following is the declaration for java.io.DataInputStream.readFully(byte[] b, int off, int len) method −

public final void readFully(byte[] b, int off, int len)

Parameters

b − The destination buffer.
off − The offset into the data.
len − The number of bytes to read.

Return Value

This method does not return any value.

Exception

IOException − If any I/O error occurs or the stream has been closed.
EOFException − If this input stream reaches the end before.

Example 1

The following example shows the usage of Java DataInputStream readFully(byte[] b, int offset, int len) method. We've created InputStream and DataInputStream references and then initialized them with FileInputStream and DataInputStream objects. In order to initialize DataInputStream(), we requires FileInputStream object. Once objects are created, we're checking if inputStream has content using available() method. Then a bytearray of available bytes is created which is then used in DataInputStream readFully() method, which populates the bytearray as per given input. Then this bytearray is iterated and printed.

import java.io.DataInputStream;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;

public class DataInputStreamDemo {
   public static void main(String[] args) throws IOException {
      InputStream is = null;
      DataInputStream dis = null;
      
      try {
         // create input stream from file input stream
         is = new FileInputStream("F:\\test.txt");
         
         // create data input stream
         dis = new DataInputStream(is);
         
         // count the available bytes form the input stream
         int count = is.available();
         
         // create buffer
         byte[] bs = new byte[count];
         
         // read data into buffer
         dis.readFully(bs, 4, 3);
         
         // for each byte in the buffer
         for (byte b:bs) {

            // print the byte
            System.out.print(b+" ");
         }
         
      } catch(Exception e) {
         // if any I/O error occurs
         e.printStackTrace();
      } finally {
         // releases any associated system files with this stream
         if(is!=null)
            is.close();
         if(dis!=null)
            dis.close();
      }   
   }
}

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

ABCDEFGH

Output

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

0 0 0 0 65 66 67 0

Example 2

The following example shows the usage of Java DataInputStream readFully(byte[] b, int offset, int len) method. We've created InputStream and DataInputStream references and then initialized them with FileInputStream and DataInputStream objects. In order to initialize DataInputStream(), we requires FileInputStream object. Once objects are created, we're checking if inputStream has content using available() method. Then a bytearray of available bytes is created which is then used in DataInputStream readFully() method, which populates the bytearray with an invalid length required as input. Then this bytearray is iterated and printed.

import java.io.DataInputStream;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;

public class DataInputStreamDemo {
   public static void main(String[] args) throws IOException {
      InputStream is = null;
      DataInputStream dis = null;
      
      try {
         // create input stream from file input stream
         is = new FileInputStream("F:\\test.txt");
         
         // create data input stream
         dis = new DataInputStream(is);
         
         // count the available bytes form the input stream
         int count = is.available();
         
         // create buffer
         byte[] bs = new byte[count];
         
         // read data into buffer with an invalid length
         dis.readFully(bs, 4, 10);
         
         // for each byte in the buffer
         for (byte b:bs) {

            // print the byte
            System.out.print(b+" ");
         }
         
      } catch(Exception e) {
         // if any I/O error occurs
         e.printStackTrace();
      } finally {
         // releases any associated system files with this stream
         if(is!=null)
            is.close();
         if(dis!=null)
            dis.close();
      }   
   }
}

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

ABCDEFGH

Output

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

java.lang.IndexOutOfBoundsException
	at java.base/java.io.FileInputStream.readBytes(Native Method)
	at java.base/java.io.FileInputStream.read(FileInputStream.java:279)
	at java.base/java.io.DataInputStream.readFully(DataInputStream.java:200)
	at DataInputStreamDemo.main(DataInputStreamDemo.java:25)

Example 3

import java.io.DataInputStream;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;

public class DataInputStreamDemo {
   public static void main(String[] args) throws IOException {
      InputStream is = null;
      DataInputStream dis = null;
      
      try {
         // create input stream from file input stream
         is = new FileInputStream("F:\\test.txt");
         
         // create data input stream
         dis = new DataInputStream(is);
         
         // count the available bytes form the input stream
         int count = is.available();
         
         // create buffer
         byte[] bs = new byte[count];
         
         // read data into buffer
         dis.readFully(bs, 0, count);
         
         // for each byte in the buffer
         for (byte b:bs) {

            // print the byte
            System.out.print(b+" ");
         }
         
      } catch(Exception e) {
         // if any I/O error occurs
         e.printStackTrace();
      } finally {
         // releases any associated system files with this stream
         if(is!=null)
            is.close();
         if(dis!=null)
            dis.close();
      }   
   }
}

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

ABCDEFGH

Output

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

65 66 67 68 69 70 71 72

java_files_io.htm