Package java.io

Interface DataOutput

All Known Subinterfaces:
ObjectOutput
All Known Implementing Classes:
DataOutputStream, ObjectOutputStream, RandomAccessFile
public interface DataOutput
Defines an interface for classes that are able to write big-endian typed data to some target. Typically, this data can be read in by a class which implements DataInput. Types that can be written include byte, 16-bit short, 32-bit int, 32-bit float, 64-bit long, 64-bit double, byte strings, and MUTF-8 encoded strings.
See Also:
DataOutputStream, RandomAccessFile

  • Method Summary

    Modifier and Type Method Description
    void write​(byte[] buffer)
    Writes the entire contents of the byte array buffer to this stream.
    void write​(byte[] buffer, int offset, int count)
    Writes count bytes from the byte array buffer starting at offset index.
    void write​(int oneByte)
    Writes the specified 8-bit byte.
    void writeBoolean​(boolean val)
    Writes the specified boolean.
    void writeByte​(int val)
    Writes the specified 8-bit byte.
    void writeBytes​(String str)
    Writes the low order 8-bit bytes from the specified string.
    void writeChar​(int val)
    Writes the specified 16-bit character in big-endian order.
    void writeChars​(String str)
    Writes the 16-bit characters contained in str in big-endian order.
    void writeDouble​(double val)
    Writes the specified 64-bit double in big-endian order.
    void writeFloat​(float val)
    Writes the specified 32-bit float in big-endian order.
    void writeInt​(int val)
    Writes the specified 32-bit int in big-endian order.
    void writeLong​(long val)
    Writes the specified 64-bit long in big-endian order.
    void writeShort​(int val)
    Writes the specified 16-bit short in big-endian order.
    void writeUTF​(String str)
    Writes the specified string encoded in modified UTF-8.

  • Method Details

    • write

      void write​(byte[] buffer) throws IOException
      Writes the entire contents of the byte array buffer to this stream.
      Parameters:
      buffer - the buffer to write.
      Throws:
      IOException - if an I/O error occurs while writing.

    • write

      void write​(byte[] buffer, int offset, int count) throws IOException
      Writes count bytes from the byte array buffer starting at offset index.
      Parameters:
      buffer - the buffer to write.
      offset - the index of the first byte in buffer to write.
      count - the number of bytes from the buffer to write.
      Throws:
      IOException - if an I/O error occurs while writing.

    • write

      void write​(int oneByte) throws IOException
      Writes the specified 8-bit byte.
      Parameters:
      oneByte - the byte to write.
      Throws:
      IOException - if an I/O error occurs while writing.
      See Also:
      DataInput.readByte()

    • writeBoolean

      void writeBoolean​(boolean val) throws IOException
      Writes the specified boolean.
      Parameters:
      val - the boolean value to write.
      Throws:
      IOException - if an I/O error occurs while writing.
      See Also:
      DataInput.readBoolean()

    • writeByte

      void writeByte​(int val) throws IOException
      Writes the specified 8-bit byte.
      Parameters:
      val - the byte value to write.
      Throws:
      IOException - if an I/O error occurs while writing.
      See Also:
      DataInput.readByte(), DataInput.readUnsignedByte()

    • writeBytes

      void writeBytes​(String str) throws IOException
      Writes the low order 8-bit bytes from the specified string.
      Parameters:
      str - the string containing the bytes to write.
      Throws:
      IOException - if an I/O error occurs while writing.

    • writeChar

      void writeChar​(int val) throws IOException
      Writes the specified 16-bit character in big-endian order. Only the two least significant bytes of the integer oneByte are written.
      Parameters:
      val - the character to write.
      Throws:
      IOException - if an I/O error occurs while writing.
      See Also:
      DataInput.readChar()

    • writeChars

      void writeChars​(String str) throws IOException
      Writes the 16-bit characters contained in str in big-endian order.
      Parameters:
      str - the string that contains the characters to write.
      Throws:
      IOException - if an I/O error occurs while writing.
      See Also:
      DataInput.readChar()

    • writeDouble

      void writeDouble​(double val) throws IOException
      Writes the specified 64-bit double in big-endian order. The resulting output is the eight bytes returned by Double.doubleToLongBits(double).
      Parameters:
      val - the double to write.
      Throws:
      IOException - if an I/O error occurs while writing.
      See Also:
      DataInput.readDouble()

    • writeFloat

      void writeFloat​(float val) throws IOException
      Writes the specified 32-bit float in big-endian order. The resulting output is the four bytes returned by Float.floatToIntBits(float).
      Parameters:
      val - the float to write.
      Throws:
      IOException - if an I/O error occurs while writing.
      See Also:
      DataInput.readFloat()

    • writeInt

      void writeInt​(int val) throws IOException
      Writes the specified 32-bit int in big-endian order.
      Parameters:
      val - the int to write.
      Throws:
      IOException - if an I/O error occurs while writing.
      See Also:
      DataInput.readInt()

    • writeLong

      void writeLong​(long val) throws IOException
      Writes the specified 64-bit long in big-endian order.
      Parameters:
      val - the long to write.
      Throws:
      IOException - if an I/O error occurs while writing.
      See Also:
      DataInput.readLong()

    • writeShort

      void writeShort​(int val) throws IOException
      Writes the specified 16-bit short in big-endian order. Only the lower two bytes of val are written.
      Parameters:
      val - the short to write.
      Throws:
      IOException - if an I/O error occurs while writing.
      See Also:
      DataInput.readShort(), DataInput.readUnsignedShort()

    • writeUTF

      void writeUTF​(String str) throws IOException
      Writes the specified string encoded in modified UTF-8.
      Parameters:
      str - the string to write encoded in modified UTF-8.
      Throws:
      IOException - if an I/O error occurs while writing.
      See Also:
      DataInput.readUTF()