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) 將指定 byte 陣列中從偏移量 off 開始的 len 個位元組寫入基礎輸出串流。
void	write(int b) 將指定位元組（參數 b 的八個低位）寫入基礎輸出串流。
void	writeBoolean(boolean v) 將一個 boolean 值以 1-byte 值形式寫入基礎輸出串流。
void	writeByte(int v) 將一個 byte 值以 1-byte 值形式寫出到基礎輸出串流中。
void	writeBytes(String s) 將字元串按位元組順序寫出到基礎輸出串流中。
void	writeChar(int v) 將一個 char 值以 2-byte 值形式寫入基礎輸出串流中，先寫入高位元組。
void	writeChars(String s) 將字元串按字元順序寫入基礎輸出串流。
void	writeDouble(double v) 使用 Double 類別中的 doubleToLongBits 方法將 double 參數轉換為一個 long 值，然後將該 long 值以 8-byte 值形式寫入基礎輸出串流中，先寫入高位元組。
void	writeFloat(float v) 使用 Float 類別中的 floatToIntBits 方法將 float 參數轉換為一個 int 值，然後將該 int 值以 4-byte 值形式寫入基礎輸出串流中，先寫入高位元組。
void	writeInt(int v) 將一個 int 值以 4-byte 值形式寫入基礎輸出串流中，先寫入高位元組。
void	writeLong(long v) 將一個 long 值以 8-byte 值形式寫入基礎輸出串流中，先寫入高位元組。
void	writeShort(int v) 將一個 short 值以 2-byte 值形式寫入基礎輸出串流中，先寫入高位元組。
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 的八個低位）寫入基礎輸出串流。如果沒有拋出異常，則計數器 written 增加 1。

實作 OutputStream 的 write 方法。

指定者：

介面 DataOutput 中的 write

覆寫：

類別 FilterOutputStream 中的 write

參數：

b - 要寫入的 byte。

拋出：

IOException - 如果發生 I/O 錯誤。

另請參見：

FilterOutputStream.out

write

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

將指定 byte 陣列中從偏移量 off 開始的 len 個位元組寫入基礎輸出串流。如果沒有拋出異常，則計數器 written 增加 len。

指定者：

介面 DataOutput 中的 write

覆寫：

類別 FilterOutputStream 中的 write

參數：

b - 資料。

off - 資料中的起始偏移量。

len - 要寫入的位元組數。

拋出：

IOException - 如果發生 I/O 錯誤。

另請參見：

FilterOutputStream.out

flush

public void flush()
           throws IOException

清空此資料輸出串流。這迫使所有緩衝的輸出位元組被寫出到串流中。

DataOutputStream 的 flush 方法調用其基礎輸出串流的 flush 方法。

指定者：

介面 Flushable 中的 flush

覆寫：

類別 FilterOutputStream 中的 flush

拋出：

IOException - 如果發生 I/O 錯誤。

另請參見：

FilterOutputStream.out, OutputStream.flush()

writeBoolean

public final void writeBoolean(boolean v)
                        throws IOException

將一個 boolean 值以 1-byte 值形式寫入基礎輸出串流。值 true 以值 (byte)1 的形式被寫出；值 false 以值 (byte)0 的形式被寫出。如果沒有拋出異常，則計數器 written 增加 1。

指定者：

介面 DataOutput 中的 writeBoolean

參數：

v - 要寫入的 boolean 值。

拋出：

IOException - 如果發生 I/O 錯誤。

另請參見：

FilterOutputStream.out

writeByte

public final void writeByte(int v)
                     throws IOException

將一個 byte 值以 1-byte 值形式寫出到基礎輸出串流中。如果沒有拋出異常，則計數器 written 增加 1。

指定者：

介面 DataOutput 中的 writeByte

參數：

v - 要寫入的 byte 值。

拋出：

IOException - 如果發生 I/O 錯誤。

另請參見：

FilterOutputStream.out

writeShort

public final void writeShort(int v)
                      throws IOException

將一個 short 值以 2-byte 值形式寫入基礎輸出串流中，先寫入高位元組。如果沒有拋出異常，則計數器 written 增加 2。

指定者：

介面 DataOutput 中的 writeShort

參數：

v - 要寫入的 short 值。

拋出：

IOException - 如果發生 I/O 錯誤。

另請參見：

FilterOutputStream.out

writeChar

public final void writeChar(int v)
                     throws IOException

將一個 char 值以 2-byte 值形式寫入基礎輸出串流中，先寫入高位元組。如果沒有拋出異常，則計數器 written 增加 2。

指定者：

介面 DataOutput 中的 writeChar

參數：

v - 要寫入的 char 值。

拋出：

IOException - 如果發生 I/O 錯誤。

另請參見：

FilterOutputStream.out

writeInt

public final void writeInt(int v)
                    throws IOException

將一個 int 值以 4-byte 值形式寫入基礎輸出串流中，先寫入高位元組。如果沒有拋出異常，則計數器 written 增加 4。

指定者：

介面 DataOutput 中的 writeInt

參數：

v - 要寫入的 int 值。

拋出：

IOException - 如果發生 I/O 錯誤。

另請參見：

FilterOutputStream.out

writeLong

public final void writeLong(long v)
                     throws IOException

將一個 long 值以 8-byte 值形式寫入基礎輸出串流中，先寫入高位元組。如果沒有拋出異常，則計數器 written 增加 8。

指定者：

介面 DataOutput 中的 writeLong

參數：

v - 要寫入的 long 值。

拋出：

IOException - 如果發生 I/O 錯誤。

另請參見：

FilterOutputStream.out

writeFloat

public final void writeFloat(float v)
                      throws IOException

使用 Float 類別中的 floatToIntBits 方法將 float 參數轉換為一個 int 值，然後將該 int 值以 4-byte 值形式寫入基礎輸出串流中，先寫入高位元組。如果沒有拋出異常，則計數器 written 增加 4。

指定者：

介面 DataOutput 中的 writeFloat

參數：

v - 要寫入的 float 值。

拋出：

IOException - 如果發生 I/O 錯誤。

另請參見：

FilterOutputStream.out, Float.floatToIntBits(float)

writeDouble

public final void writeDouble(double v)
                       throws IOException

使用 Double 類別中的 doubleToLongBits 方法將 double 參數轉換為一個 long 值，然後將該 long 值以 8-byte 值形式寫入基礎輸出串流中，先寫入高位元組。如果沒有拋出異常，則計數器 written 增加 8。

指定者：

介面 DataOutput 中的 writeDouble

參數：

v - 要寫入的 double 值。

拋出：

IOException - 如果發生 I/O 錯誤。

另請參見：

FilterOutputStream.out, Double.doubleToLongBits(double)

writeBytes

public final void writeBytes(String s)
                      throws IOException

將字元串按位元組順序寫出到基礎輸出串流中。按順序寫出字元串中每個字元，丟棄其八個高位。如果沒有拋出異常，則計數器 written 增加 s 的長度。

指定者：

介面 DataOutput 中的 writeBytes

參數：

s - 要寫入的位元組字元串。

拋出：

IOException - 如果發生 I/O 錯誤。

另請參見：

FilterOutputStream.out

writeChars

public final void writeChars(String s)
                      throws IOException

將字元串按字元順序寫入基礎輸出串流。通過 writeChar 方法將每個字元寫入資料輸出串流。如果沒有拋出異常，則計數器 written 增加 s 長度的兩倍。

指定者：

介面 DataOutput 中的 writeChars

參數：

s - 要寫入的 String 值。

拋出：

IOException - 如果發生 I/O 錯誤。

另請參見：

writeChar(int), FilterOutputStream.out

writeUTF

public final void writeUTF(String str)
                    throws IOException

以與機器無關方式使用 UTF-8 修改版編碼將一個字元串寫入基礎輸出串流。

首先，通過 writeShort 方法將兩個位元組寫入輸出串流，表示後跟的位元組數。該值是實際寫出的位元組數，不是字元串的長度。根據此長度，使用字元的 UTF-8 修改版編碼按順序輸出字元串的每個字元。如果沒有拋出異常，則計數器 written 增加寫入輸出串流的位元組總數。該值至少是 2 加 str 的長度，最多是 2 加 str 的三倍長度。

指定者：

介面 DataOutput 中的 writeUTF

參數：

str - 要寫入的字元串。

拋出：

IOException - 如果發生 I/O 錯誤。

size

public final int size()

返回計數器 written 的當前值，即到目前為止寫入此資料輸出串流的位元組數。如果計數器溢位，則將它包裹到 Integer.MAX_VALUE。

返回：

written 欄位的值。

另請參見：

written