java.io
類別 OutputStream

java.lang.Object
  java.io.OutputStream

所有已實作的介面：

Closeable, Flushable

直接已知子類別：

ByteArrayOutputStream, FileOutputStream, FilterOutputStream, ObjectOutputStream, OutputStream, PipedOutputStream

public abstract class OutputStream
extends Object
implements Closeable, Flushable

此抽象類別是表示輸出位元組串流的全部類別的父級類別。輸出串流接受輸出位元組並將這些位元組發送到某個接收器。

需要定義 OutputStream 子類別的應用程序必須始終提供至少一種可寫入一個輸出位元組的方法。

從以下版本開始：

JDK1.0

另請參見：

BufferedOutputStream, ByteArrayOutputStream, DataOutputStream, FilterOutputStream, InputStream, write(int)

建構子摘要

OutputStream()

方法摘要

void	close() 關閉此輸出串流並釋放與此串流有關的所有系統資源。
void	flush() 刷新此輸出串流並強制寫出所有緩衝的輸出位元組。
void	write(byte[] b) 將 b.length 個位元組從指定的 byte 陣列寫入此輸出串流。
void	write(byte[] b, int off, int len) 將指定 byte 陣列中從偏移量 off 開始的 len 個位元組寫入此輸出串流。
abstract void	write(int b) 將指定的位元組寫入此輸出串流。

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

建構子詳細資訊

OutputStream

public OutputStream()

方法詳細資訊

write

public abstract void write(int b)
                    throws IOException

將指定的位元組寫入此輸出串流。write 的常規協定是：向輸出串流寫入一個位元組。要寫入的位元組是參數 b 的八個低位。b 的 24 個高位將被忽略。

OutputStream 的子類別必須提供此方法的實作。

參數：

b - 位元組

拋出：

IOException - 如果發生 I/O 錯誤。尤其是，如果已關閉輸出串流，則可能拋出 IOException。

write

public void write(byte[] b)
           throws IOException

將 b.length 個位元組從指定的 byte 陣列寫入此輸出串流。write(b) 的常規協定是：應該與調用 write(b, 0, b.length) 的效果完全相同。

參數：

b - 資料。

拋出：

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

另請參見：

write(byte[], int, int)

write

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

將指定 byte 陣列中從偏移量 off 開始的 len 個位元組寫入此輸出串流。write(b, off, len) 的常規協定是：將陣列 b 中的某些位元組按順序寫入輸出串流；元素 b[off] 是此操作寫入的第一個位元組，b[off+len-1] 是此操作寫入的最後一個位元組。

OutputStream 的 write 方法對每個要寫出的位元組調用一個參數的 write 方法。建議子類別覆寫此方法並提供更有效的實作。

如果 b 為 null，則拋出 NullPointerException。

如果 off 為負，或 len 為負，或者 off+len 大於陣列 b 的長度，則拋出 IndexOutOfBoundsException。

參數：

b - 資料。

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

len - 要寫入的位元組數。

拋出：

IOException - 如果發生 I/O 錯誤。尤其是，如果關閉了輸出串流，則拋出 IOException。

flush

public void flush()
           throws IOException

刷新此輸出串流並強制寫出所有緩衝的輸出位元組。flush 的常規協定是：如果此輸出串流的實作已經緩衝了以前寫入的任何位元組，則調用此方法指示應將這些位元組立即寫入它們預期的目標。

如果此串流的預期目標是由基礎作業系統提供的一個抽象（如一個檔案），則刷新此串流只能保證將以前寫入到串流的位元組傳遞給作業系統進行寫入，但不保證能將這些位元組實際寫入到物理設備（如磁碟驅動器）。

OutputStream 的 flush 方法不執行任何操作。

指定者：

介面 Flushable 中的 flush

拋出：

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

close

public void close()
           throws IOException

關閉此輸出串流並釋放與此串流有關的所有系統資源。close 的常規協定是：該方法將關閉輸出串流。關閉的串流不能執行輸出操作，也不能重新打開。

OutputStream 的 close 方法不執行任何操作。

指定者：

介面 Closeable 中的 close

拋出：

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