鴻蒙OS OutputStream

2022-10-21 17:42 更新

OutputStream

java.lang.Object

|---java.io.OutputStream

  1. public abstract class OutputStream
  2. extends Object
  3. implements Closeable, Flushable

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

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

Since:

JDK1.0

構(gòu)造函數(shù)摘要

構(gòu)造函數(shù) 描述
OutputStream()

方法總結(jié)

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

構(gòu)造函數(shù)詳細(xì)信息

OutputStream

public OutputStream()

方法詳情

write

public abstract void write(int b) throws IOException

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

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

參數(shù):

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

Throws:

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

write

public void write(byte[] b) throws IOException

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

參數(shù):

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

Throws:

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

write

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

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

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

如果 b 為 null,則拋出 NullPointerException。

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

參數(shù):

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

Throws:

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

flush

public void flush() throws IOException

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

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

OutputStream 的 flush 方法什么都不做。

指定者:

在接口 Flushable 中刷新

Throws:

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

close

public void close() throws IOException

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

OutputStream 的 close 方法什么也不做。

指定者:

在接口 AutoCloseable 中關(guān)閉

指定者:

在接口Closeable中關(guān)閉

Throws:

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

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)