java.io
クラス DataOutputStream

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

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

DataOutput

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 エンコーディングを使った形式にして基本となる出力ストリームに書き込みます まず、最初の 2 バイトが writeShort メソッドと同じ方法で出力ストリームに書き込まれ、これがあとに続くバイト数を示します。

クラス 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

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

DataOuputStream の flush メソッドが、基本となる出力ストリームの 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