Class LittleEndianDataInputStream

  • All Implemented Interfaces:
    java.io.Closeable, java.io.DataInput, java.lang.AutoCloseable

    @GwtIncompatible
    public final class LittleEndianDataInputStream
    extends java.io.FilterInputStream
    implements java.io.DataInput
    An implementation of DataInput that uses little-endian byte ordering for reading short, int, float, double, and long values.

    Note: This class intentionally violates the specification of its supertype DataInput, which explicitly requires big-endian byte order.

    Since:
    8.0
    Author:
    Chris Nokleberg, Keith Bottner
    • Field Summary

      • Fields inherited from class java.io.FilterInputStream

        in
    • Constructor Summary

      Constructors 
      Constructor Description
      LittleEndianDataInputStream​(java.io.InputStream in)
      Creates a LittleEndianDataInputStream that wraps the given stream.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      boolean readBoolean()  
      byte readByte()  
      char readChar()
      Reads a char as specified by DataInputStream.readChar(), except using little-endian byte order.
      double readDouble()
      Reads a double as specified by DataInputStream.readDouble(), except using little-endian byte order.
      float readFloat()
      Reads a float as specified by DataInputStream.readFloat(), except using little-endian byte order.
      void readFully​(byte[] b)  
      void readFully​(byte[] b, int off, int len)  
      int readInt()
      Reads an integer as specified by DataInputStream.readInt(), except using little-endian byte order.
      java.lang.String readLine()
      This method will throw an UnsupportedOperationException.
      long readLong()
      Reads a long as specified by DataInputStream.readLong(), except using little-endian byte order.
      short readShort()
      Reads a short as specified by DataInputStream.readShort(), except using little-endian byte order.
      int readUnsignedByte()  
      int readUnsignedShort()
      Reads an unsigned short as specified by DataInputStream.readUnsignedShort(), except using little-endian byte order.
      java.lang.String readUTF()  
      int skipBytes​(int n)  
      • Methods inherited from class java.io.FilterInputStream

        available, close, mark, markSupported, read, read, read, reset, skip
      • Methods inherited from class java.io.InputStream

        nullInputStream, readAllBytes, readNBytes, readNBytes, transferTo
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • LittleEndianDataInputStream

        public LittleEndianDataInputStream​(java.io.InputStream in)
        Creates a LittleEndianDataInputStream that wraps the given stream.
        Parameters:
        in - the stream to delegate to
    • Method Detail

      • readLine

        @CanIgnoreReturnValue
        public java.lang.String readLine()
        This method will throw an UnsupportedOperationException.
        Specified by:
        readLine in interface java.io.DataInput
      • readFully

        public void readFully​(byte[] b)
                       throws java.io.IOException
        Specified by:
        readFully in interface java.io.DataInput
        Throws:
        java.io.IOException
      • readFully

        public void readFully​(byte[] b,
                              int off,
                              int len)
                       throws java.io.IOException
        Specified by:
        readFully in interface java.io.DataInput
        Throws:
        java.io.IOException
      • skipBytes

        public int skipBytes​(int n)
                      throws java.io.IOException
        Specified by:
        skipBytes in interface java.io.DataInput
        Throws:
        java.io.IOException
      • readUnsignedByte

        @CanIgnoreReturnValue
        public int readUnsignedByte()
                             throws java.io.IOException
        Specified by:
        readUnsignedByte in interface java.io.DataInput
        Throws:
        java.io.IOException
      • readUnsignedShort

        @CanIgnoreReturnValue
        public int readUnsignedShort()
                              throws java.io.IOException
        Reads an unsigned short as specified by DataInputStream.readUnsignedShort(), except using little-endian byte order.
        Specified by:
        readUnsignedShort in interface java.io.DataInput
        Returns:
        the next two bytes of the input stream, interpreted as an unsigned 16-bit integer in little-endian byte order
        Throws:
        java.io.IOException - if an I/O error occurs
      • readInt

        @CanIgnoreReturnValue
        public int readInt()
                    throws java.io.IOException
        Reads an integer as specified by DataInputStream.readInt(), except using little-endian byte order.
        Specified by:
        readInt in interface java.io.DataInput
        Returns:
        the next four bytes of the input stream, interpreted as an int in little-endian byte order
        Throws:
        java.io.IOException - if an I/O error occurs
      • readLong

        @CanIgnoreReturnValue
        public long readLong()
                      throws java.io.IOException
        Reads a long as specified by DataInputStream.readLong(), except using little-endian byte order.
        Specified by:
        readLong in interface java.io.DataInput
        Returns:
        the next eight bytes of the input stream, interpreted as a long in little-endian byte order
        Throws:
        java.io.IOException - if an I/O error occurs
      • readFloat

        @CanIgnoreReturnValue
        public float readFloat()
                        throws java.io.IOException
        Reads a float as specified by DataInputStream.readFloat(), except using little-endian byte order.
        Specified by:
        readFloat in interface java.io.DataInput
        Returns:
        the next four bytes of the input stream, interpreted as a float in little-endian byte order
        Throws:
        java.io.IOException - if an I/O error occurs
      • readDouble

        @CanIgnoreReturnValue
        public double readDouble()
                          throws java.io.IOException
        Reads a double as specified by DataInputStream.readDouble(), except using little-endian byte order.
        Specified by:
        readDouble in interface java.io.DataInput
        Returns:
        the next eight bytes of the input stream, interpreted as a double in little-endian byte order
        Throws:
        java.io.IOException - if an I/O error occurs
      • readUTF

        @CanIgnoreReturnValue
        public java.lang.String readUTF()
                                 throws java.io.IOException
        Specified by:
        readUTF in interface java.io.DataInput
        Throws:
        java.io.IOException
      • readShort

        @CanIgnoreReturnValue
        public short readShort()
                        throws java.io.IOException
        Reads a short as specified by DataInputStream.readShort(), except using little-endian byte order.
        Specified by:
        readShort in interface java.io.DataInput
        Returns:
        the next two bytes of the input stream, interpreted as a short in little-endian byte order.
        Throws:
        java.io.IOException - if an I/O error occurs.
      • readChar

        @CanIgnoreReturnValue
        public char readChar()
                      throws java.io.IOException
        Reads a char as specified by DataInputStream.readChar(), except using little-endian byte order.
        Specified by:
        readChar in interface java.io.DataInput
        Returns:
        the next two bytes of the input stream, interpreted as a char in little-endian byte order
        Throws:
        java.io.IOException - if an I/O error occurs
      • readByte

        @CanIgnoreReturnValue
        public byte readByte()
                      throws java.io.IOException
        Specified by:
        readByte in interface java.io.DataInput
        Throws:
        java.io.IOException
      • readBoolean

        @CanIgnoreReturnValue
        public boolean readBoolean()
                            throws java.io.IOException
        Specified by:
        readBoolean in interface java.io.DataInput
        Throws:
        java.io.IOException