Most visited

Recently visited

Added in API level 1

CharArrayWriter

public class CharArrayWriter
extends Writer

java.lang.Object
    java.io.Writer
      java.io.CharArrayWriter


这个类实现了可以用作Writer的字符缓冲区。 数据写入流时缓冲区会自动增长。 数据可以使用toCharArray()和toString()来检索。

注意:对此类调用close()不起作用,可以在流关闭后调用此类的方法,而不产生IOException。

摘要(Summary)

Fields

protected char[] buf

数据存储的缓冲区。

protected int count

缓冲区中的字符数。

Inherited fields

From class java.io.Writer

Public constructors

CharArrayWriter()

创建一个新的CharArrayWriter。

CharArrayWriter(int initialSize)

用指定的初始大小创建一个新的CharArrayWriter。

公共方法(Public methods)

CharArrayWriter append(char c)

将指定的字符附加到此作者。

CharArrayWriter append(CharSequence csq, int start, int end)

将指定字符序列的子序列附加到此作者。

CharArrayWriter append(CharSequence csq)

将指定的字符序列追加到此作者。

void close()

关闭流。

void flush()

冲洗流。

void reset()

重置缓冲区,以便您可以再次使用它而不会丢弃已分配的缓冲区。

int size()

返回缓冲区的当前大小。

char[] toCharArray()

返回输入数据的副本。

String toString()

将输入数据转换为字符串。

void write(int c)

将字符写入缓冲区。

void write(String str, int off, int len)

将一部分字符串写入缓冲区。

void write(char[] c, int off, int len)

将字符写入缓冲区。

void writeTo(Writer out)

将缓冲区的内容写入另一个字符流。

继承方法(Inherited methods)

From class java.io.Writer
From class java.lang.Object
From interface java.lang.Appendable
From interface java.io.Closeable
From interface java.io.Flushable
From interface java.lang.AutoCloseable

Fields

buf

Added in API level 1
char[] buf

数据存储的缓冲区。

count

Added in API level 1
int count

缓冲区中的字符数。

Public constructors

CharArrayWriter

Added in API level 1
CharArrayWriter ()

创建一个新的CharArrayWriter。

CharArrayWriter

Added in API level 1
CharArrayWriter (int initialSize)

用指定的初始大小创建一个新的CharArrayWriter。

参数(Parameters)
initialSize int: an int specifying the initial buffer size.
抛出异常(Throws)
IllegalArgumentException if initialSize is negative

公共方法(Public methods)

append

Added in API level 1
CharArrayWriter append (char c)

将指定的字符附加到此作者。

表单 out.append(c)的此方法的调用的行为与调用完全相同

     out.write(c) 

参数(Parameters)
c char: The 16-bit character to append
返回(Returns)
CharArrayWriter This writer

append

Added in API level 1
CharArrayWriter append (CharSequence csq, 
                int start, 
                int end)

将指定字符序列的子序列附加到此作者。

形式的这种方法的调用时 out.append(csq, start, end) csq不是 null,行为以完全相同的方式调用

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

参数(Parameters)
csq CharSequence: The character sequence from which a subsequence will be appended. If csq is null, then characters will be appended as if csq contained the four characters "null".
start int: The index of the first character in the subsequence
end int: The index of the character following the last character in the subsequence
返回(Returns)
CharArrayWriter This writer
抛出异常(Throws)
IndexOutOfBoundsException If start or end are negative, start is greater than end, or end is greater than csq.length()

append

Added in API level 1
CharArrayWriter append (CharSequence csq)

将指定的字符序列追加到此作者。

调用表单 out.append(csq)的此方法的行为与调用完全相同

     out.write(csq.toString()) 

取决于toString字符序列csq本说明书中,整个序列可以不追加。 例如,调用字符缓冲区的toString方法将返回一个子序列,其内容取决于缓冲区的位置和限制。

参数(Parameters)
csq CharSequence: The character sequence to append. If csq is null, then the four characters "null" are appended to this writer.
返回(Returns)
CharArrayWriter This writer

close

Added in API level 1
void close ()

关闭流。 此方法不释放缓冲区,因为它的内容可能仍然是必需的。 注意:在这个类中调用此方法将不起作用。

flush

Added in API level 1
void flush ()

冲洗流。

reset

Added in API level 1
void reset ()

重置缓冲区,以便您可以再次使用它而不会丢弃已分配的缓冲区。

size

Added in API level 1
int size ()

返回缓冲区的当前大小。

返回(Returns)
int an int representing the current size of the buffer.

toCharArray

Added in API level 1
char[] toCharArray ()

返回输入数据的副本。

返回(Returns)
char[] an array of chars copied from the input data.

toString

Added in API level 1
String toString ()

将输入数据转换为字符串。

返回(Returns)
String the string.

write

Added in API level 1
void write (int c)

将字符写入缓冲区。

参数(Parameters)
c int: int specifying a character to be written

write

Added in API level 1
void write (String str, 
                int off, 
                int len)

将一部分字符串写入缓冲区。

参数(Parameters)
str String: String to be written from
off int: Offset from which to start reading characters
len int: Number of characters to be written

write

Added in API level 1
void write (char[] c, 
                int off, 
                int len)

将字符写入缓冲区。

参数(Parameters)
c char: the data to be written
off int: the start offset in the data
len int: the number of chars that are written

writeTo

Added in API level 1
void writeTo (Writer out)

将缓冲区的内容写入另一个字符流。

参数(Parameters)
out Writer: the output stream to write to
抛出异常(Throws)
IOException If an I/O error occurs.

Hooray!