モジュール java.base
パッケージ java.io

インタフェースDataOutput

既知のすべてのサブインタフェース:
ImageOutputStream, ObjectOutput
既知のすべての実装クラス:
DataOutputStream, FileCacheImageOutputStream, FileImageOutputStream, ImageOutputStreamImpl, MemoryCacheImageOutputStream, ObjectOutputStream, RandomAccessFile
public interface DataOutput
DataOutputインタフェースは、Javaのプリミティブ型があればそのデータを一連のバイトに変換してバイナリ・ストリームに書き込むために提供されています。 また、Stringを修正UTF-8形式に変換して結果の一連のバイトを書き込む機能もあります。

このインタフェースのバイトを書き込むすべてのメソッドでは、なんらかの理由でバイトを書き込めない場合は、通常、IOExceptionがスローされます。

導入されたバージョン:
1.0
関連項目:

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    write(byte[] b)
    出力ストリームに配列bのすべてのバイトを書き込みます。
    void
    write(byte[] b, int off, int len)
    配列bからlenバイトを順番に出力ストリームに書き込みます。
    void
    write(int b)
    引数bの下位8ビットを出力ストリームに書き込みます。
    void
    writeBoolean(boolean v)
    1つのboolean値をこの出力ストリームに書き込みます。
    void
    writeByte(int v)
    引数vの8つの下位ビットを出力ストリームに書き込みます。
    void
    writeBytes(String s)
    文字列を出力ストリームに書き込みます。
    void
    writeChar(int v)
    2バイトで構成されるchar値を出力ストリームに書き込みます。
    void
    writeChars(String s)
    文字列s内の各文字を、1文字ごとに2バイトずつ順番に書き込みます。
    void
    writeDouble(double v)
    8バイトで構成されるdouble値を出力ストリームに書き込みます。
    void
    writeFloat(float v)
    4バイトで構成されるfloat値を出力ストリームに書き込みます。
    void
    writeInt(int v)
    4バイトで構成されるint値を出力ストリームに書き込みます。
    void
    writeLong(long v)
    8バイトで構成されるlong値を出力ストリームに書き込みます。
    void
    writeShort(int v)
    引数の値を表す2バイトを出力ストリームに書き込みます。
    void
    writeUTF(String s)
    2バイトの長さ情報を出力ストリームに書き込みます。その後ろに、文字列s内の各文字の修正UTF-8表現が続きます。

  • メソッドの詳細

    • write

      void write(int b) throws IOException
      引数bの下位8ビットを出力ストリームに書き込みます。 bの上位24ビットは無視されます。
      パラメータ:
      b - 書き込まれるバイト。
      例外:
      IOException - 入出力エラーが発生した場合。

    • write

      void write(byte[] b) throws IOException
      出力ストリームに配列bのすべてのバイトを書き込みます。 bがnullの場合、NullPointerExceptionがスローされます。 b.lengthがゼロの場合、バイトは書き込まれません。 それ以外の場合は、最初にバイトb[0]が書き込まれ、次にb[1]という具合に続き、最後に書き込まれるバイトはb[b.length-1]になります。
      パラメータ:
      b - データ。
      例外:
      IOException - 入出力エラーが発生した場合。

    • write

      void write(byte[] b, int off, int len) throws IOException
      配列bからlenバイトを順番に出力ストリームに書き込みます。 bがnullの場合、NullPointerExceptionがスローされます。 offが負の場合、lenが負の場合、またはoff+lenが配列bの長さよりも大きい場合は、IndexOutOfBoundsExceptionがスローされます。 lenがゼロの場合、バイトは書き込まれません。 それ以外の場合は、最初にバイトb[off]が書き込まれ、次にb[off+1]という具合に続き、最後に書き込まれるバイトはb[off+len-1]になります。
      パラメータ:
      b - データ。
      off - データの開始オフセット。
      len - 書き込むバイト数。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeBoolean

      void writeBoolean(boolean v) throws IOException
      1つのboolean値をこの出力ストリームに書き込みます。 引数vがtrueの場合は値(byte)1が書き込まれ、vがfalseの場合は値(byte)0が書き込まれます。 このメソッドによって書き込まれたバイトは、インタフェースDataInputのreadBooleanメソッドによって読み取られ、そのあとに、vに相当するbooleanが返されます。
      パラメータ:
      v - 書き込まれるboolean。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeByte

      void writeByte(int v) throws IOException
      引数vの8つの下位ビットを出力ストリームに書き込みます。 vの上位24ビットは無視されます。 これはwriteByteが、整数引数のwriteとまったく同じであることを意味します。 このメソッドによって書き込まれたバイトは、インタフェースDataInputのreadByteメソッドによって読み取られ、そのあとに、(byte)vに相当するbyteが返されます。
      パラメータ:
      v - 書き込まれるバイト値。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeShort

      void writeShort(int v) throws IOException
      引数の値を表す2バイトを出力ストリームに書き込みます。 次に示すバイト値が、この順番で書き込まれます。 
      
 (byte)(0xff & (v >> 8))
 (byte)(0xff & v)

      このメソッドによって書き込まれたバイトは、インタフェースDataInputのreadShortメソッドによって読み取られ、(short)vに等しいshortが返されます。

      パラメータ:
      v - 書き込まれるshort値。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeChar

      void writeChar(int v) throws IOException
      2バイトで構成されるchar値を出力ストリームに書き込みます。 次に示すバイト値が、この順番で書き込まれます。 
      
 (byte)(0xff & (v >> 8))
 (byte)(0xff & v)

      このメソッドによって書き込まれたバイトは、インタフェースDataInputのreadCharメソッドによって読み取られ、(char)vに等しいcharが返されます。

      パラメータ:
      v - 書き込まれるchar値。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeInt

      void writeInt(int v) throws IOException
      4バイトで構成されるint値を出力ストリームに書き込みます。 次に示すバイト値が、この順番で書き込まれます。 
      
 (byte)(0xff & (v >> 24))
 (byte)(0xff & (v >> 16))
 (byte)(0xff & (v >>  8))
 (byte)(0xff & v)

      このメソッドによって書き込まれたバイトは、インタフェースDataInputのreadIntメソッドによって読み取られ、vに等しいintが返されます。

      パラメータ:
      v - 書き込まれるint値。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeLong

      void writeLong(long v) throws IOException
      8バイトで構成されるlong値を出力ストリームに書き込みます。 次に示すバイト値が、この順番で書き込まれます。 
      
 (byte)(0xff & (v >> 56))
 (byte)(0xff & (v >> 48))
 (byte)(0xff & (v >> 40))
 (byte)(0xff & (v >> 32))
 (byte)(0xff & (v >> 24))
 (byte)(0xff & (v >> 16))
 (byte)(0xff & (v >>  8))
 (byte)(0xff & v)

      このメソッドによって書き込まれたバイトは、インタフェースDataInputのreadLongメソッドによって読み取られ、vに等しいlongが返されます。

      パラメータ:
      v - 書き込まれるlong値。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeFloat

      void writeFloat(float v) throws IOException
      4バイトで構成されるfloat値を出力ストリームに書き込みます。 これは、最初にこのfloat値をFloat.floatToIntBitsメソッドと同じ方法でintに変換し、次にint値をwriteIntメソッドと同じ方法で書き込むようにして行われます。 このメソッドによって書き込まれたバイトは、インタフェースDataInputのreadFloatメソッドによって読み取られ、そのあとに、vに相当するfloatが返されます。
      パラメータ:
      v - 書き込まれるfloat値。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeDouble

      void writeDouble(double v) throws IOException
      8バイトで構成されるdouble値を出力ストリームに書き込みます。 これは、最初にこのdouble値をDouble.doubleToLongBitsメソッドと同じ方法でlongに変換し、次にlong値をwriteLongメソッドと同じ方法で書き込むようにして行われます。 このメソッドによって書き込まれたバイトは、インタフェースDataInputのreadDoubleメソッドによって読み取られ、そのあとに、vに相当するdoubleが返されます。
      パラメータ:
      v - 書き込まれるdouble値。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeBytes

      void writeBytes(String s) throws IOException
      文字列を出力ストリームに書き込みます。 文字列sの各文字が順番に取り出され、1バイトが出力ストリームに書き込まれます。 sがnullの場合、NullPointerExceptionがスローされます。

      s.lengthがゼロの場合、バイトは書き込まれません。 それ以外の場合は、最初に文字s[0]が書き込まれ、次にs[1]という具合に続き、最後に書き込まれる文字はs[s.length-1]になります。 各文字については、writeByteメソッドとまったく同じ方法で、1バイト、つまり下位バイトが書き込まれます。 文字列内の各文字の上位8ビットは無視されます。

      パラメータ:
      s - 書き込まれるバイトの文字列。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeChars

      void writeChars(String s) throws IOException
      文字列s内の各文字を、1文字ごとに2バイトずつ順番に書き込みます。 sがnullの場合、NullPointerExceptionがスローされます。 s.lengthがゼロの場合、書き込まれる文字はありません。 それ以外の場合は、最初に文字s[0]が書き込まれ、次にs[1]という具合に続き、最後に書き込まれる文字はs[s.length-1]になります。 各文字については、writeCharメソッドとまったく同じ方法で、上位バイトを先にして2バイトが実際に書き込まれます。
      パラメータ:
      s - 書き込まれる文字列値。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeUTF

      void writeUTF(String s) throws IOException
      2バイトの長さ情報を出力ストリームに書き込みます。その後ろに、文字列s内の各文字の修正UTF-8表現が続きます。 sがnullの場合、NullPointerExceptionがスローされます。 文字列s内の各文字は、文字の値に基づいて、1、2、または3バイトのグループに変換されます。

      文字cが\u0001 - \u007fの範囲にある場合、次のような1バイトで表現されます。 

      (byte)c

      文字cが\u0000の場合や、\u0080 - \u07ffの範囲にある場合には、次の順序で書き込まれる2バイトによって表されます。 

      
 (byte)(0xc0 | (0x1f & (c >> 6)))
 (byte)(0x80 | (0x3f & c))

      文字cが\u0800 - uffffの範囲にある場合、次の順序で書き込まれる3バイトによって表されます。 

      
 (byte)(0xe0 | (0x0f & (c >> 12)))
 (byte)(0x80 | (0x3f & (c >>  6)))
 (byte)(0x80 | (0x3f & c))

      まず、sのすべての文字を表すのに必要な総バイト数が計算されます。 この数値が65535を超える場合は、UTFDataFormatExceptionがスローされます。 それ以外の場合は、この長さがwriteShortメソッドとまったく同じ方法で出力ストリームに書き込まれます。次に、文字列s内の各文字の1、2、または3バイト表現が書き込まれます。

      このメソッドによって書き込まれたバイトは、インタフェースDataInputのreadUTFメソッドによって読み取られ、sに等しいStringが返されます。

      パラメータ:
      s - 書き込まれる文字列値。
      例外:
      IOException - 入出力エラーが発生した場合。