java.io
クラス DataOutputStream

java.lang.Object
  |
  +--java.io.OutputStream
        |
        +--java.io.DataOutputStream
すべての実装インタフェース:
DataOutput

public class DataOutputStream
extends OutputStream
implements DataOutput

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

導入されたバージョン:
JDK1.0
関連項目:
DataInputStream

フィールドの概要
protected  OutputStream out
          出力ストリームです。
 
コンストラクタの概要
DataOutputStream(OutputStream out)
          指定された基本となる出力ストリームへデータを書き込むための、データ出力ストリームを新しく作成します。
 
メソッドの概要
 void close()
          出力ストリームを閉じ、これに関連するすべてのシステムリソースを解放します。
 void flush()
          データ出力ストリームをフラッシュします。
 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 writeChar(int v)
          char を、上位バイトを先頭とする 2 バイトデータとして基本となる出力ストリームに書き込みます。
 void writeChars(String s)
          文字列を基本となる出力ストリームに一連の文字型データとして書き込みます。
 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.OutputStream から継承したメソッド
write
 
クラス java.lang.Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

out

protected OutputStream out
出力ストリームです。
コンストラクタの詳細

DataOutputStream

public DataOutputStream(OutputStream out)
指定された基本となる出力ストリームへデータを書き込むための、データ出力ストリームを新しく作成します。カウンタ written がゼロに設定されます。
パラメータ:
out - あとで使うために保存される基本となる出力ストリーム
メソッドの詳細

write

public void write(int b)
           throws IOException
指定されたバイト (引数 b の下位 8 ビット) を基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written1 だけ増加します。

OutputStreamwrite メソッドを実装します。

定義:
インタフェース DataOutput 内の write
オーバーライド:
クラス OutputStream 内の write
パラメータ:
b - 書き込まれる byte
例外:
IOException - 入出力エラーが発生した場合

write

public void write(byte[] b,
                  int off,
                  int len)
           throws IOException
指定されたバイト配列のオフセット位置 off から始まる len バイトを基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ writtenlen の値だけ増加します。
定義:
インタフェース DataOutput 内の write
オーバーライド:
クラス OutputStream 内の write
パラメータ:
b - データ
off - データの開始オフセット
len - 書き込むバイト数
例外:
IOException - 入出力エラーが発生した場合

flush

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

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

オーバーライド:
クラス OutputStream 内の flush
例外:
IOException - 入出力エラーが発生した場合

close

public void close()
           throws IOException
出力ストリームを閉じ、これに関連するすべてのシステムリソースを解放します。

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

オーバーライド:
クラス OutputStream 内の close
例外:
IOException - 入出力エラーが発生した場合

writeBoolean

public final void writeBoolean(boolean v)
                        throws IOException
boolean 値を 1 バイトデータとして基本となるデータ出力ストリームに書き込みます。true(byte)1 として、false(byte)0 として書き込まれます。例外がスローされない場合、カウンタ written1 だけ増加します。
定義:
インタフェース DataOutput 内の writeBoolean
パラメータ:
v - 書き込まれる boolean
例外:
IOException - 入出力エラーが発生した場合

writeByte

public final void writeByte(int v)
                     throws IOException
byte 値を 1 バイト値として基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written1 だけ増加します。
定義:
インタフェース DataOutput 内の writeByte
パラメータ:
v - 書き込まれる byte
例外:
IOException - 入出力エラーが発生した場合

writeShort

public final void writeShort(int v)
                      throws IOException
short 型データを、上位バイトを先頭とする 2 バイトデータとして基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written2 だけ増加します。
定義:
インタフェース DataOutput 内の writeShort
パラメータ:
v - 書き込まれる short
例外:
IOException - 入出力エラーが発生した場合

writeChar

public final void writeChar(int v)
                     throws IOException
char を、上位バイトを先頭とする 2 バイトデータとして基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written2 だけ増加します。
定義:
インタフェース DataOutput 内の writeChar
パラメータ:
v - 書き込まれる char
例外:
IOException - 入出力エラーが発生した場合

writeInt

public final void writeInt(int v)
                    throws IOException
int 型データを、上位バイトを先頭とする 4 バイトデータとして基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written4 だけ増加します。
定義:
インタフェース DataOutput 内の writeInt
パラメータ:
v - 書き込まれる int
例外:
IOException - 入出力エラーが発生した場合

writeLong

public final void writeLong(long v)
                     throws IOException
long 型データを、上位バイトを先頭とする 8 バイトデータとして基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written8 だけ増加します。
定義:
インタフェース DataOutput 内の writeLong
パラメータ:
v - 書き込まれる long
例外:
IOException - 入出力エラーが発生した場合

writeChars

public final void writeChars(String s)
                      throws IOException
文字列を基本となる出力ストリームに一連の文字型データとして書き込みます。各文字データは writeChar メソッドと同じ方法で順番にデータ出力ストリームに書き込まれます。例外がスローされない場合、カウンタ writtens の長さの 2 倍だけ増加します。
定義:
インタフェース DataOutput 内の writeChars
パラメータ:
s - 書き込まれる String
例外:
IOException - 入出力エラーが発生した場合
関連項目:
writeChar(int)

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 - 入出力エラーが発生した場合