Home » Java programming language

Java DataInputStream readUnsignedByte() Method with Example

DataInputStream Class readUnsignedByte() method: Here, we are going to learn about the readUnsignedByte() method of DataInputStream Class with its syntax and example.
Submitted by Preeti Jain, on March 30, 2020

DataInputStream Class readUnsignedByte() method

• readUnsignedByte() method is available in java.io package.
• readUnsignedByte() method is used to read 1 byte (i.e. 8 bit) of data input and returns an unsigned byte value read.
• readUnsignedByte() method is a non-static method, it is accessible with the class object only and if we try to access the method with the class name then we will get an error.
• readUnsignedByte() method may throw an exception at the time of reading byte.
  • IOException: This exception may throw when this stream is not opened.
  • EndOfFileException: This exception may throw when this stream has reached its endpoint.

Syntax:

    public final int readUnsignedByte();

Parameter(s):

• It does not accept any parameter.

Return value:

The return type of the method is int, it returns 1 byte of data input, manipulated as an unsigned byte value.

Example:

// Java program to demonstrate the example 
// of int readUnsignedByte() method of 
// DataInputStream

import java.io.*;

public class ReadUnsignedByteOfDIS {
 public static void main(String[] args) throws IOException {
  InputStream is_stm = null;
  DataInputStream dis_stm = null;
  FileOutputStream fos_stm = null;
  DataOutputStream dos_stm = null;
  byte[] b_arr = {
   125,
   111,
   -121,
   -112
  };

  try {
   // Instantiate FileInputStream, 
   // DataInputStream, FileOutputStream
   // and DataOutputStream 

   fos_stm = new FileOutputStream("C:\\Users\\Preeti Jain\\Desktop\\programs\\includehelp.txt");
   dos_stm = new DataOutputStream(fos_stm);

   // Loop to write each byte till end
   for (byte val: b_arr) {
    // By using writeByte() method isto
    // write a byte value to the
    // DataOutputStream dos_stm
    dos_stm.writeByte(val);
   }

   is_stm = new FileInputStream("C:\\Users\\Preeti Jain\\Desktop\\programs\\includehelp.txt");
   dis_stm = new DataInputStream(is_stm);

   // Loop To Read Available Data till end
   while (dis_stm.available() > 0) {
    // By using readUnsignedByte() method isto read 
    // unsigned byte at a time from dis_stm
    int in = dis_stm.readUnsignedByte();
    System.out.println("dis_stm.readUnsignedByte(): " + in );
   }
  } catch (Exception ex) {
   System.out.println(ex.toString());
  } finally {
   // To free system resources linked
   // with these streams
   if (is_stm != null)
    is_stm.close();

   if (dis_stm != null)
    dis_stm.close();

   if (dos_stm != null)
    dos_stm.close();

   if (fos_stm != null)
    fos_stm.close();
  }
 }
}

Output

dis_stm.readUnsignedByte(): 125
dis_stm.readUnsignedByte(): 111
dis_stm.readUnsignedByte(): 135
dis_stm.readUnsignedByte(): 144