JavaTM Platform
Standard Ed. 6

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 ビット) を基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written1 だけ増加します。  

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

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

write

public void write(byte[] b,
                  int off,
                  int len)
           throws IOException
指定されたバイト配列のオフセット位置 off から始まる len バイトを基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ writtenlen の値だけ増加します。

定義:
インタフェース DataOutput 内の write
オーバーライド:
クラス FilterOutputStream 内の write
パラメータ:
b - データ
off - データの開始オフセット
len - 書き込むバイト数
例外:
IOException - 入出力エラーが発生した場合
関連項目:
FilterOutputStream.out

flush

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

DataOutputStreamflush メソッドが、基本となる出力ストリームの 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 として書き込まれます。例外がスローされない場合、カウンタ written1 だけ増加します。

定義:
インタフェース DataOutput 内の writeBoolean
パラメータ:
v - 書き込まれる boolean
例外:
IOException - 入出力エラーが発生した場合
関連項目:
FilterOutputStream.out

writeByte

public final void writeByte(int v)
                     throws IOException
byte 値を 1 バイト値として基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written1 だけ増加します。

定義:
インタフェース DataOutput 内の writeByte
パラメータ:
v - 書き込まれる byte
例外:
IOException - 入出力エラーが発生した場合
関連項目:
FilterOutputStream.out

writeShort

public final void writeShort(int v)
                      throws IOException
short 型データを、上位バイトを先頭とする 2 バイトデータとして基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written2 だけ増加します。

定義:
インタフェース DataOutput 内の writeShort
パラメータ:
v - 書き込まれる short
例外:
IOException - 入出力エラーが発生した場合
関連項目:
FilterOutputStream.out

writeChar

public final void writeChar(int v)
                     throws IOException
char を、上位バイトを先頭とする 2 バイトデータとして基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written2 だけ増加します。

定義:
インタフェース DataOutput 内の writeChar
パラメータ:
v - 書き込まれる char
例外:
IOException - 入出力エラーが発生した場合
関連項目:
FilterOutputStream.out

writeInt

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

定義:
インタフェース DataOutput 内の writeInt
パラメータ:
v - 書き込まれる int
例外:
IOException - 入出力エラーが発生した場合
関連項目:
FilterOutputStream.out

writeLong

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

定義:
インタフェース DataOutput 内の writeLong
パラメータ:
v - 書き込まれる long
例外:
IOException - 入出力エラーが発生した場合
関連項目:
FilterOutputStream.out

writeFloat

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

定義:
インタフェース 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 バイトデータとして基本となる出力ストリームに書き込みます。例外がスローされない場合、カウンタ written8 だけ増加します。

定義:
インタフェース DataOutput 内の writeDouble
パラメータ:
v - 書き込まれる double
例外:
IOException - 入出力エラーが発生した場合
関連項目:
FilterOutputStream.out, Double.doubleToLongBits(double)

writeBytes

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

定義:
インタフェース DataOutput 内の writeBytes
パラメータ:
s - 書き込まれるバイトの文字列
例外:
IOException - 入出力エラーが発生した場合
関連項目:
FilterOutputStream.out

writeChars

public final void writeChars(String s)
                      throws IOException
文字列を基本となる出力ストリームに一連の文字型データとして書き込みます。各文字データは writeChar メソッドと同じ方法で順番にデータ出力ストリームに書き込まれます。例外がスローされない場合、カウンタ writtens の長さの 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

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。