Package java.io

Class DataInputStream

java.lang.Object
java.io.InputStream
java.io.FilterInputStream
java.io.DataInputStream
All Implemented Interfaces:
Closeable, DataInput, AutoCloseable
public class DataInputStream
extends FilterInputStream
implements DataInput
Wraps an existing InputStream and reads big-endian typed data from it. Typically, this stream has been written by a DataOutputStream. Types that can be read include byte, 16-bit short, 32-bit int, 32-bit float, 64-bit long, 64-bit double, byte strings, and strings encoded in modified UTF-8.
See Also:
DataOutputStream

  • Field Summary

    Fields inherited from class java.io.FilterInputStream

    in

  • Constructor Summary

    Constructors 
    Constructor Description
    DataInputStream​(InputStream in)
    Constructs a new DataInputStream on the InputStream in.

  • Method Summary

    Modifier and Type Method Description
    int read​(byte[] buffer)
    Equivalent to read(buffer, 0, buffer.length).
    int read​(byte[] buffer, int byteOffset, int byteCount)
    Reads up to byteCount bytes from this stream and stores them in the byte array buffer starting at byteOffset.
    boolean readBoolean()
    Reads a boolean.
    byte readByte()
    Reads an 8-bit byte value.
    char readChar()
    Reads a big-endian 16-bit character value.
    double readDouble()
    Reads a big-endian 64-bit double value.
    float readFloat()
    Reads a big-endian 32-bit float value.
    void readFully​(byte[] dst)
    Equivalent to readFully(dst, 0, dst.length);.
    void readFully​(byte[] dst, int offset, int byteCount)
    Reads byteCount bytes from this stream and stores them in the byte array dst starting at offset.
    int readInt()
    Reads a big-endian 32-bit integer value.
    String readLine()
    Deprecated.
    This method cannot be trusted to convert bytes to characters correctly.
    long readLong()
    Reads a big-endian 64-bit long value.
    short readShort()
    Reads a big-endian 16-bit short value.
    int readUnsignedByte()
    Reads an unsigned 8-bit byte value and returns it as an int.
    int readUnsignedShort()
    Reads a big-endian 16-bit unsigned short value and returns it as an int.
    String readUTF()
    Reads a string encoded with modified UTF-8.
    static String readUTF​(DataInput in)  
    int skipBytes​(int count)
    Skips count number of bytes in this stream.

    Methods inherited from class java.io.FilterInputStream

    available, close, mark, markSupported, read, reset, skip

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Constructor Details

    • DataInputStream

      public DataInputStream​(InputStream in)
      Constructs a new DataInputStream on the InputStream in. All reads are then filtered through this stream. Note that data read by this stream is not in a human readable format and was most likely created by a DataOutputStream.

      Warning: passing a null source creates an invalid DataInputStream. All operations on such a stream will fail.

      Parameters:
      in - the source InputStream the filter reads from.
      See Also:
      DataOutputStream, RandomAccessFile

  • Method Details