鴻蒙OS Writer

Writer

java.lang.Object

|---java.io.Writer

public abstract class Writer
extends Object
implements Appendable, Closeable, Flushable

用于寫入字符流的抽象類。 子類必須實現(xiàn)的唯一方法是 write(char[], int, int)、flush() 和 close()。 然而，大多數(shù)子類將覆蓋此處定義的一些方法，以提供更高的效率、附加功能或兩者兼而有之。

Since:

JDK1.1

字段摘要

構造函數(shù)摘要

方法總結

字段詳細信息

lock

protected Object lock

用于同步此流上的操作的對象。 為了提高效率，字符流對象可以使用自身以外的對象來保護臨界區(qū)。 因此，子類應該使用該字段中的對象而不是 this 或同步方法。

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

Writer

protected Writer()

創(chuàng)建一個新的字符流編寫器，其關鍵部分將在編寫器本身上同步。

Writer

protected Writer(Object lock)

創(chuàng)建一個新的字符流編寫器，其關鍵部分將在給定對象上同步。

參數(shù)：

方法詳情

write

public void write(int c) throws IOException

寫入單個字符。 要寫入的字符包含在給定整數(shù)值的低 16 位中； 16 個高位被忽略。

打算支持高效單字符輸出的子類應覆蓋此方法。

參數(shù)：

Throws:

write

public void write(char[] cbuf) throws IOException

寫入一個字符數(shù)組。

參數(shù)：

Throws:

write

public abstract void write(char[] cbuf, int off, int len) throws IOException

寫入字符數(shù)組的一部分。

參數(shù)：

Throws:

write

public void write(String str) throws IOException

寫入一個字符串。

參數(shù)：

Throws:

write

public void write(String str, int off, int len) throws IOException

寫入字符串的一部分。

參數(shù)：

Throws:

append

public Writer append(CharSequence csq) throws IOException

將指定的字符序列附加到此編寫器。

形式為 out.append(csq) 的此方法的調用與調用的行為方式完全相同

     out.write(csq.toString()) 

根據字符序列 csq 的 toString 規(guī)范，可能不會附加整個序列。 例如，調用字符緩沖區(qū)的 toString 方法將返回一個子序列，其內容取決于緩沖區(qū)的位置和限制。

指定者：

在接口 Appendable 中追加

參數(shù)：

返回:

This writer

Throws:

Since:

1.5

append

public Writer append(CharSequence csq, int start, int end) throws IOException

將指定字符序列的子序列附加到此編寫器。 可附加的。

當 csq 不為空時，以 out.append(csq, start, end) 形式調用此方法的行為與調用完全相同

     out.write(csq.subSequence(start, end).toString()) 

指定者：

在接口 Appendable 中追加

參數(shù)：

返回:

This writer

Throws:

Since:

1.5

append

public Writer append(char c) throws IOException

將指定的字符附加到這個 writer。

以 out.append(c) 形式調用此方法的行為與調用完全相同

     out.write(c) 

指定者：

在接口 Appendable 中追加

參數(shù)：

返回:

This writer

Throws:

Since:

1.5

flush

public abstract void flush() throws IOException

沖洗流。 如果流已將來自各種 write() 方法的任何字符保存在緩沖區(qū)中，請立即將它們寫入其預期目的地。 然后，如果該目的地是另一個字符或字節(jié)流，則刷新它。 因此，一次 flush() 調用將刷新 Writers 和 OutputStreams 鏈中的所有緩沖區(qū)。

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

指定者：

在接口 Flushable 中刷新

Throws:

close

public abstract void close() throws IOException

關閉流，首先刷新它。 一旦流被關閉，進一步的 write() 或 flush() 調用將導致拋出 IOException。 關閉以前關閉的流沒有效果。

指定者：

在接口 AutoCloseable 中關閉

指定者：

在接口Closeable中關閉

Throws: