DataOutput (Java Platform SE 8)

既知のすべてのサブインタフェース:

ImageOutputStream, ObjectOutput

既知のすべての実装クラス:

DataOutputStream, FileCacheImageOutputStream, FileImageOutputStream, ImageOutputStreamImpl, MemoryCacheImageOutputStream, ObjectOutputStream, RandomAccessFile
```
public interface DataOutput
```
DataOutputインタフェースは、Javaのプリミティブ型があればそのデータを一連のバイトに変換してバイナリ・ストリームに書き込むために提供されています。また、Stringを修正UTF-8形式に変換して結果の一連のバイトを書き込む機能もあります。
このインタフェースのバイトを書き込むすべてのメソッドでは、なんらかの理由でバイトを書き込めない場合は、通常、IOExceptionがスローされます。

導入されたバージョン:

JDK1.0

関連項目:

DataInput, DataOutputStream

メソッドのサマリー

すべてのメソッドインスタンス・メソッド抽象メソッド
修飾子と型	メソッド	説明
`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 - 入出力エラーが発生した場合。

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

インタフェースDataOutput

メソッドのサマリー

メソッドの詳細

write

write

write

writeBoolean

writeByte

writeShort

writeChar

writeInt

writeLong

writeFloat

writeDouble

writeBytes

writeChars

writeUTF