java.io
クラス DataOutputStream

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

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

Closeable, DataOutput, Flushable

public class DataOutputStream
extends FilterOutputStream
implements DataOutput

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

導入されたバージョン:

JDK1.0

関連項目:

DataInputStream

フィールドの概要

protected int

written それまでにデータ出力ストリームに書き込まれたバイト数です。

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

out

コンストラクタの概要

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 型の引数を Double クラスの doubleToLongBits メソッドを使って long に変換し、その long データを、上位バイトを先頭とする 8 バイトデータとして基本となる出力ストリームに書き込みます。
void	writeFloat(float v) float 型引数を Float クラスの floatToIntBits メソッドを使って 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 メソッドを実装します。

定義:

インタフェース DataOutput 内の write

オーバーライド:

クラス FilterOutputStream 内の write

パラメータ:

b - 書き込まれる byte

例外:

IOException - 入出力エラーが発生した場合

関連項目:

FilterOutputStream.out

write

public void write(byte[] b,
                  int off,
                  int len)
           throws IOException

指定されたバイト配列のオフセット位置 off から始まる len バイトを基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written は len の値だけ増加します。

定義:

インタフェース DataOutput 内の write

オーバーライド:

クラス FilterOutputStream 内の write

パラメータ:

b - データ

off - データの開始オフセット

len - 書き込むバイト数

例外:

IOException - 入出力エラーが発生した場合

関連項目:

FilterOutputStream.out

flush

public void flush()
           throws IOException

データ出力ストリームをフラッシュします。バッファリングされている出力データは、強制的にストリームに書き込まれます。

DataOutputStream の flush メソッドが、基本となる出力ストリームの flush メソッドを呼び出します。

定義:

インタフェース Flushable 内の flush

オーバーライド:

クラス FilterOutputStream 内の flush

例外:

IOException - 入出力エラーが発生した場合

関連項目:

FilterOutputStream.out, OutputStream.flush()

writeBoolean

public final void writeBoolean(boolean v)
                        throws IOException

boolean 値を 1 バイトデータとして基本となるデータ出力ストリームに書き込みます。true は (byte)1 として、false は (byte)0 として書き込まれます。例外がスローされない場合、カウンタ written は 1 だけ増加します。

定義:

インタフェース DataOutput 内の writeBoolean

パラメータ:

v - 書き込まれる boolean 値

例外:

IOException - 入出力エラーが発生した場合

関連項目:

FilterOutputStream.out

writeByte

public final void writeByte(int v)
                     throws IOException

byte 値を 1 バイト値として基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written は 1 だけ増加します。

定義:

インタフェース DataOutput 内の writeByte

パラメータ:

v - 書き込まれる byte 値

例外:

IOException - 入出力エラーが発生した場合

関連項目:

FilterOutputStream.out

writeShort

public final void writeShort(int v)
                      throws IOException

short 型データを、上位バイトを先頭とする 2 バイトデータとして基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written は 2 だけ増加します。

定義:

インタフェース DataOutput 内の writeShort

パラメータ:

v - 書き込まれる short 値

例外:

IOException - 入出力エラーが発生した場合

関連項目:

FilterOutputStream.out

writeChar

public final void writeChar(int v)
                     throws IOException

char を、上位バイトを先頭とする 2 バイトデータとして基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written は 2 だけ増加します。

定義:

インタフェース DataOutput 内の writeChar

パラメータ:

v - 書き込まれる char 値

例外:

IOException - 入出力エラーが発生した場合

関連項目:

FilterOutputStream.out

writeInt

public final void writeInt(int v)
                    throws IOException

int 型データを、上位バイトを先頭とする 4 バイトデータとして基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written は 4 だけ増加します。

定義:

インタフェース DataOutput 内の writeInt

パラメータ:

v - 書き込まれる int 値

例外:

IOException - 入出力エラーが発生した場合

関連項目:

FilterOutputStream.out

writeLong

public final void writeLong(long v)
                     throws IOException

long 型データを、上位バイトを先頭とする 8 バイトデータとして基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written は 8 だけ増加します。

定義:

インタフェース DataOutput 内の writeLong

パラメータ:

v - 書き込まれる long 値

例外:

IOException - 入出力エラーが発生した場合

関連項目:

FilterOutputStream.out

writeFloat

public final void writeFloat(float v)
                      throws IOException

float 型引数を Float クラスの floatToIntBits メソッドを使って int 型に変換し、その int 型データを上位バイトを先頭とする 4 バイトとして基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written は 4 だけ増加します。

定義:

インタフェース DataOutput 内の writeFloat

パラメータ:

v - 書き込まれる float 値

例外:

IOException - 入出力エラーが発生した場合

関連項目:

FilterOutputStream.out, Float.floatToIntBits(float)

writeDouble

public final void writeDouble(double v)
                       throws IOException

double 型の引数を Double クラスの doubleToLongBits メソッドを使って long に変換し、その long データを、上位バイトを先頭とする 8 バイトデータとして基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written は 8 だけ増加します。

定義:

インタフェース DataOutput 内の writeDouble

パラメータ:

v - 書き込まれる double 値

例外:

IOException - 入出力エラーが発生した場合

関連項目:

FilterOutputStream.out, Double.doubleToLongBits(double)

writeBytes

public final void writeBytes(String s)
                      throws IOException

文字列を基本となる出力ストリームに一連のバイトとして書き込みます。文字列中の各文字型データは順番に書き込まれ、このとき最上位ビットは無視されます。例外がスローされない場合、カウンタ written は s の長さだけ増加します。

定義:

インタフェース DataOutput 内の writeBytes

パラメータ:

s - 書き込まれるバイトの文字列

例外:

IOException - 入出力エラーが発生した場合

関連項目:

FilterOutputStream.out

writeChars

public final void writeChars(String s)
                      throws IOException

文字列を基本となる出力ストリームに一連の文字型データとして書き込みます。各文字データは writeChar メソッドと同じ方法で順番にデータ出力ストリームに書き込まれます。例外がスローされない場合、カウンタ written は s の長さの 2 倍だけ増加します。

定義:

インタフェース DataOutput 内の writeChars

パラメータ:

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 倍を加えた値以下になります。

定義:

インタフェース DataOutput 内の writeUTF

パラメータ:

str - 書き込まれる文字列

例外:

IOException - 入出力エラーが発生した場合

size

public final int size()

カウンタ written の現在の値、つまりこのデータ出力ストリームにこれまでに書き込まれたバイト数を返します。このカウンタがオーバーフローすると、Integer.MAX_VALUE にラップされます。

戻り値:

written フィールドの値

関連項目:

written