DataOutputStream (Java Platform SE 7)

java.lang.Object
- java.io.OutputStream
- - java.io.FilterOutputStream
  - - java.io.DataOutputStream

すべての実装されたインタフェース:

Closeable, DataOutput, Flushable, AutoCloseable
```
public class DataOutputStream
extends FilterOutputStream
implements DataOutput
```
データ出力ストリームを使うと、アプリケーションはプリミティブ型の Java データを移植性のある形で出力ストリームに書き込むことができます。アプリケーションはデータ入力ストリームを使ってデータを読み戻すことができます。

導入されたバージョン:

JDK1.0

関連項目:
DataInputStream

フィールドのサマリー

フィールド
修飾子と型フィールドと説明

protected int written
それまでにデータ出力ストリームに書き込まれたバイト数です。
- クラス java.io.FilterOutputStream から継承されたフィールド
  out

フィールド
修飾子と型	フィールドと説明
`protected int`	`written` それまでにデータ出力ストリームに書き込まれたバイト数です。

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`DataOutputStream(OutputStream out)` 指定されたベースとなる出力ストリームへデータを書き込むための、データ出力ストリームを新しく作成します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`void`	`flush()` データ出力ストリームをフラッシュします。
`int`	`size()` カウンタ `written` の現在の値、つまりこのデータ出力ストリームにこれまでに書き込まれたバイト数を返します。
`void`	`write(byte[] b, int off, int len)` 指定されたバイト配列のオフセット位置 `off` から始まる `len` バイトをベースとなる出力ストリームに書き込みます。
`void`	`write(int b)` 指定されたバイト (引数 `b` の下位 8 ビット) をベースとなる出力ストリームに書き込みます。
`void`	`writeBoolean(boolean v)` `boolean` 値を 1 バイト値としてベースとなる出力ストリームに書き込みます。
`void`	`writeByte(int v)` `byte` 値を 1 バイト値としてベースとなる出力ストリームに書き込みます。
`void`	`writeBytes(String s)` 文字列をベースとなる出力ストリームに一連のバイトとして書き込みます。
`void`	`writeChar(int v)` `char` 値を 2 バイト値として上位バイトから先にベースとなる出力ストリームに書き込みます。
`void`	`writeChars(String s)` 文字列をベースとなる出力ストリームに一連の文字型データとして書き込みます。
`void`	`writeDouble(double v)` `Double` クラスの `doubleToLongBits` メソッドを使って double 型の引数を `long` 型に変換してから、その `long` 値を 8 バイト値として上位バイトから先にベースとなる出力ストリームに書き込みます。
`void`	`writeFloat(float v)` `Float` クラスの `floatToIntBits` メソッドを使って float 型の引数を `int` 型に変換してから、その `int` 値を 4 バイト値として上位バイトから先にベースとなる出力ストリームに書き込みます。
`void`	`writeInt(int v)` `int` 値を 4 バイト値として上位バイトから先にベースとなる出力ストリームに書き込みます。
`void`	`writeLong(long v)` `long` 値を 8 バイト値として上位バイトから先にベースとなる出力ストリームに書き込みます。
`void`	`writeShort(int v)` `short` 値を 2 バイト値として上位バイトから先にベースとなる出力ストリームに書き込みます。
`void`	`writeUTF(String str)` 修正 UTF-8 エンコーディングを使って、マシンに依存しない方法で文字列をベースとなる出力ストリームに書き込みます。

クラス java.io.FilterOutputStream から継承されたメソッド
close, write

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

インタフェース java.io.DataOutput から継承されたメソッド
write

- フィールドの詳細
  - written
```
protected int written
```
    それまでにデータ出力ストリームに書き込まれたバイト数です。このカウンタがオーバーフローすると、Integer.MAX_VALUE にラップされます。
- コンストラクタの詳細
  - DataOutputStream
```
public DataOutputStream(OutputStream out)
```
    指定されたベースとなる出力ストリームへデータを書き込むための、データ出力ストリームを新しく作成します。カウンタ written がゼロに設定されます。
    
    パラメータ:
    out - あとで使うために保存されるベースとなる出力ストリーム。
    関連項目:
    FilterOutputStream.out
- メソッドの詳細
  - write
```
public void write(int b)
           throws IOException
```
    指定されたバイト (引数 b の下位 8 ビット) をベースとなる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written は 1 だけ増加します。
    OutputStream の write メソッドを実装します。
    
    定義:
    
    write、インタフェース: DataOutput
    
    オーバーライド:
    
    write、クラス: FilterOutputStream
    
    パラメータ:
    b - 書き込まれる byte。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    関連項目:
    FilterOutputStream.out
  - write
```
public void write(byte[] b,
         int off,
         int len)
           throws IOException
```
    指定されたバイト配列のオフセット位置 off から始まる len バイトをベースとなる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written は len だけ増加します。
    
    定義:
    
    write、インタフェース: DataOutput
    
    オーバーライド:
    
    write、クラス: FilterOutputStream
    
    パラメータ:
    b - データ。
    off - データの開始オフセット。
    len - 書き込むバイト数。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    関連項目:
    FilterOutputStream.out
  - flush
```
public void flush()
           throws IOException
```
    データ出力ストリームをフラッシュします。バッファリングされている出力データは、強制的にストリームに書き込まれます。
    DataOutputStream の flush メソッドはそのベースとなる出力ストリームの flush メソッドを呼び出します。
    
    定義:
    
    flush、インタフェース: Flushable
    
    オーバーライド:
    
    flush、クラス: FilterOutputStream
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    関連項目:
    FilterOutputStream.out, OutputStream.flush()
  - writeBoolean
```
public final void writeBoolean(boolean v)
                        throws IOException
```
    boolean 値を 1 バイト値としてベースとなる出力ストリームに書き込みます。値 true は値 (byte)1 として書き込まれ、値 false は値 (byte)0 として書き込まれます。例外がスローされない場合、カウンタ written は 1 だけ増加します。
    
    定義:
    
    writeBoolean、インタフェース: DataOutput
    
    パラメータ:
    v - 書き込まれる boolean 値。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    関連項目:
    FilterOutputStream.out
  - writeByte
```
public final void writeByte(int v)
                     throws IOException
```
    byte 値を 1 バイト値としてベースとなる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written は 1 だけ増加します。
    
    定義:
    
    writeByte、インタフェース: DataOutput
    
    パラメータ:
    v - 書き込まれる byte 値。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    関連項目:
    FilterOutputStream.out
  - writeShort
```
public final void writeShort(int v)
                      throws IOException
```
    short 値を 2 バイト値として上位バイトから先にベースとなる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written は 2 だけ増加します。
    
    定義:
    
    writeShort、インタフェース: DataOutput
    
    パラメータ:
    v - 書き込まれる short 値。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    関連項目:
    FilterOutputStream.out
  - writeChar
```
public final void writeChar(int v)
                     throws IOException
```
    char 値を 2 バイト値として上位バイトから先にベースとなる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written は 2 だけ増加します。
    
    定義:
    
    writeChar、インタフェース: DataOutput
    
    パラメータ:
    v - 書き込まれる char 値。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    関連項目:
    FilterOutputStream.out
  - writeInt
```
public final void writeInt(int v)
                    throws IOException
```
    int 値を 4 バイト値として上位バイトから先にベースとなる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written は 4 だけ増加します。
    
    定義:
    
    writeInt、インタフェース: DataOutput
    
    パラメータ:
    v - 書き込まれる int 値。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    関連項目:
    FilterOutputStream.out
  - writeLong
```
public final void writeLong(long v)
                     throws IOException
```
    long 値を 8 バイト値として上位バイトから先にベースとなる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written は 8 だけ増加します。
    
    定義:
    
    writeLong、インタフェース: DataOutput
    
    パラメータ:
    v - 書き込まれる long 値。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    関連項目:
    FilterOutputStream.out
  - writeFloat
```
public final void writeFloat(float v)
                      throws IOException
```
    Float クラスの floatToIntBits メソッドを使って float 型の引数を int 型に変換してから、その int 値を 4 バイト値として上位バイトから先にベースとなる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written は 4 だけ増加します。
    
    定義:
    
    writeFloat、インタフェース: DataOutput
    
    パラメータ:
    v - 書き込まれる float 値。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    関連項目:
    FilterOutputStream.out, Float.floatToIntBits(float)
  - writeDouble
```
public final void writeDouble(double v)
                       throws IOException
```
    Double クラスの doubleToLongBits メソッドを使って double 型の引数を long 型に変換してから、その long 値を 8 バイト値として上位バイトから先にベースとなる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written は 8 だけ増加します。
    
    定義:
    
    writeDouble、インタフェース: DataOutput
    
    パラメータ:
    v - 書き込まれる double 値。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    関連項目:
    FilterOutputStream.out, Double.doubleToLongBits(double)
  - writeBytes
```
public final void writeBytes(String s)
                      throws IOException
```
    文字列をベースとなる出力ストリームに一連のバイトとして書き込みます。文字列の各文字は、高位の 8 ビットを破棄して順に書き込まれます。例外がスローされない場合、カウンタ written は s の長さだけ増加します。
    
    定義:
    
    writeBytes、インタフェース: DataOutput
    
    パラメータ:
    s - 書き込まれるバイトの文字列。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    関連項目:
    FilterOutputStream.out
  - writeChars
```
public final void writeChars(String s)
                      throws IOException
```
    文字列をベースとなる出力ストリームに一連の文字型データとして書き込みます。各文字は、writeChar メソッドを使用した場合のように、データ出力ストリームに書き込まれます。例外がスローされない場合、カウンタ written は s の長さの 2 倍だけ増加します。
    
    定義:
    
    writeChars、インタフェース: DataOutput
    
    パラメータ:
    s - 書き込まれる String 値。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    関連項目:
    writeChar(int), FilterOutputStream.out
  - writeUTF
```
public final void writeUTF(String str)
                    throws IOException
```
    修正 UTF-8 エンコーディングを使って、マシンに依存しない方法で文字列をベースとなる出力ストリームに書き込みます。
    まず、最初の 2 バイトが writeShort メソッドと同じ方法で出力ストリームに書き込まれ、これがあとに続くバイト数を示します。この値は、実際に書き込まれるバイト数であり、文字列の長さではありません。この長さ情報に続いて、文字列の各文字データが順番に修正 UTF-8 エンコーディングで出力されます。例外がスローされない場合、カウンタ written は出力ストリームに書き込まれた総バイト数だけ増加します。これは、2 に str の長さを加えた値以上で、2 に str の長さの 3 倍を加えた値以下になります。
    
    定義:
    
    writeUTF、インタフェース: DataOutput
    
    パラメータ:
    str - 書き込まれる文字列。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
  - size
```
public final int size()
```
    カウンタ written の現在の値、つまりこのデータ出力ストリームにこれまでに書き込まれたバイト数を返します。このカウンタがオーバーフローすると、Integer.MAX_VALUE にラップされます。
    
    戻り値:
    written フィールドの値。
    関連項目:
    written

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

クラス DataOutputStream

フィールドのサマリー

クラス java.io.FilterOutputStream から継承されたフィールド

コンストラクタのサマリー

メソッドのサマリー

クラス java.io.FilterOutputStream から継承されたメソッド

クラス java.lang.Object から継承されたメソッド

インタフェース java.io.DataOutput から継承されたメソッド

フィールドの詳細

written

コンストラクタの詳細

DataOutputStream

メソッドの詳細

write

write

flush

writeBoolean

writeByte

writeShort

writeChar

writeInt

writeLong

writeFloat

writeDouble

writeBytes

writeChars

writeUTF

size