Java プラットフォーム 1.2

java.io
クラス DataOutputStream

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

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
 

フィールドの詳細

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
パラメータ:
b - 書き込む byte データ
例外:
IOException - 入出力エラーが発生した場合
オーバーライド:
クラス FilterOutputStream 内の write
関連項目:
FilterOutputStream.out

write

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

flush

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

DataOuputStreamflush メソッドが基礎出力ストリームの flush メソッドを呼び出します。

例外:
IOException - 入出力エラーが発生した場合
オーバーライド:
クラス FilterOutputStream 内の flush
関連項目:
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

Java プラットフォーム 1.2

バグや機能要求の報告
新しい javadoc の表示についてのコメントやご提案
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.