THE PACKAGE JAVA.IO

java.io.DataInput

22.1

22.1 The Interface

java.io.DataInput

The

DataInput

 interface provides for reading bytes from a binary stream and

reconstructing from them data in any of the Java primitive types. There is also a

facility for reconstructing a

String

 from data in Java modified UTF 8 format.

The

DataOutput

 interface ( 22.2) supports the creation of binary output data

suitable for reading back in through the

DataInput

 interface.

The

DataInput

 interface is implemented by classes

DataInputStream

( 22.11) and

RandomAccessFile

 ( 22.23).

public interface DataInput {

public void readFully(byte[] b)

throws IOException, NullPointerException;

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

throws IOException, NullPointerException,

IndexOutOfBoundsException;

public int skipBytes(int n) throws IOException;

public boolean readBoolean() throws IOException;

public byte readByte() throws IOException;

public int readUnsignedByte() throws IOException;

public short readShort() throws IOException;

public int readUnsignedShort() throws IOException;

public char readChar() throws IOException;

public int readInt() throws IOException;

public long readLong() throws IOException;

public float readFloat() throws IOException;

public double readDouble() throws IOException;

public String readLine() throws IOException;

public String readUTF() throws IOException;

}

It is generally true of all the reading routines in this interface that if end of file

is reached before the desired number of bytes has been read, an

EOFException

(which is a kind of

IOException

) is thrown. If any byte cannot be read for any

reason other than end of file, an

IOException

 other than

EOFException

 is

thrown. In particular, an

IOException

 may be thrown if the input stream has been

closed ( 22.3.6).

667