鴻蒙OS OutputStream

2022-10-21 17:42 更新

OutputStream

java.lang.Object

|---java.io.OutputStream

public abstract class OutputStream
extends Object
implements Closeable, Flushable

這個抽象類是代表字節(jié)輸出流的所有類的超類。 輸出流接受輸出字節(jié)并將它們發(fā)送到某個接收器。

需要定義 OutputStream 子類的應用程序必須始終提供至少一個寫入一個字節(jié)輸出的方法。

Since:

JDK1.0

構造函數(shù)摘要

構造函數(shù) 描述
OutputStream()

方法總結

修飾符和類型 方法 描述
void close() 關閉此輸出流并釋放與此流關聯(lián)的所有系統(tǒng)資源。
void flush() 刷新此輸出流并強制寫出任何緩沖的輸出字節(jié)。
void write(byte[] b) 將指定字節(jié)數(shù)組中的 b.length 個字節(jié)寫入此輸出流。
void write(byte[] b, int off, int len) 將指定字節(jié)數(shù)組中的 len 個字節(jié)寫入此輸出流。
abstract void write(int b) 將指定字節(jié)寫入此輸出流。
從類 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

構造函數(shù)詳細信息

OutputStream

public OutputStream()

方法詳情

write

public abstract void write(int b) throws IOException

將指定字節(jié)寫入此輸出流。 寫入的一般約定是將一個字節(jié)寫入輸出流。 要寫入的字節(jié)是參數(shù) b 的 8 個低位。 b 的高 24 位被忽略。

OutputStream 的子類必須提供此方法的實現(xiàn)。

參數(shù):

參數(shù)名稱 參數(shù)描述
b 字節(jié)。

Throws:

Throw名稱 Throw描述
IOException 如果發(fā)生 I/O 錯誤。 特別是,如果輸出流已關閉,則可能會引發(fā) IOException。

write

public void write(byte[] b) throws IOException

將指定字節(jié)數(shù)組中的 b.length 個字節(jié)寫入此輸出流。 write(b) 的一般約定是它應該與調(diào)用 write(b, 0, b.length) 具有完全相同的效果。

參數(shù):

參數(shù)名稱 參數(shù)描述
b 數(shù)據(jù)。

Throws:

Throw名稱 Throw描述
IOException 如果發(fā)生 I/O 錯誤。

write

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

將指定字節(jié)數(shù)組中的 len 個字節(jié)寫入此輸出流。 write(b, off, len) 的一般約定是數(shù)組 b 中的一些字節(jié)按順序寫入輸出流; 元素 b[off] 是寫入的第一個字節(jié), b[off+len-1] 是此操作寫入的最后一個字節(jié)。

OutputStream 的 write 方法在要寫出的每個字節(jié)上調(diào)用一個參數(shù)的 write 方法。 鼓勵子類重寫此方法并提供更有效的實現(xiàn)。

如果 b 為 null,則拋出 NullPointerException。

如果 off 為負數(shù),或 len 為負數(shù),或 off+len 大于數(shù)組 b 的長度,則拋出 IndexOutOfBoundsException。

參數(shù):

參數(shù)名稱 參數(shù)描述
b 數(shù)據(jù)。
off 數(shù)據(jù)中的起始偏移量。
len 要寫入的字節(jié)數(shù)。

Throws:

Throw名稱 Throw描述
IOException 如果發(fā)生 I/O 錯誤。 特別是,如果輸出流關閉,則會引發(fā) IOException。

flush

public void flush() throws IOException

刷新此輸出流并強制寫出任何緩沖的輸出字節(jié)。 flush 的一般約定是調(diào)用它表示,如果先前寫入的任何字節(jié)已被輸出流的實現(xiàn)緩沖,則應立即將這些字節(jié)寫入其預期目的地。

如果此流的預期目的地是底層操作系統(tǒng)提供的抽象,例如文件,則刷新流僅保證先前寫入流的字節(jié)被傳遞給操作系統(tǒng)進行寫入; 它不能保證它們實際上被寫入了物理設備,例如磁盤驅動器。

OutputStream 的 flush 方法什么都不做。

指定者:

在接口 Flushable 中刷新

Throws:

Throw名稱 Throw描述
IOException 如果發(fā)生 I/O 錯誤。

close

public void close() throws IOException

關閉此輸出流并釋放與此流關聯(lián)的所有系統(tǒng)資源。 close 的一般約定是它關閉輸出流。 關閉的流無法執(zhí)行輸出操作,也無法重新打開。

OutputStream 的 close 方法什么也不做。

指定者:

在接口 AutoCloseable 中關閉

指定者:

在接口Closeable中關閉

Throws:

Throw名稱 Throw描述
IOException 如果發(fā)生 I/O 錯誤。
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號