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

インタフェースDataOutput

    • メソッドのサマリー

      修飾子と型 メソッド 説明
      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 - 入出力エラーが発生した場合。