java.io.CharArrayWriter翻译

 Overview Package  Class Use Tree Deprecated Index Help Java^TM 2 Platform
Std. Ed. v1.4.2  PREV CLASS   NEXT CLASSFRAMES    NO FRAMES     All Classes SUMMARY: NESTED | FIELD | CONSTR | METHODDETAIL: FIELD | CONSTR | METHOD

---

java.io
Class CharArrayWriter

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

---

public class CharArrayWriter

extends Writer

This class implements a character buffer that can be used as an Writer. The buffer automatically grows when data is written to the stream. The data can be retrieved using toCharArray() and toString(). 该类实现了一个字符缓冲，可以作为Writer使用。当数据写入该流时，缓冲会自动增长。 使用toCharArray()和toString()可以获取数据。

Since:

JDK1.1

---

Field Summaryprotected  char[]buf
          The buffer where data is stored. 数据存入的缓冲。protected  intcount
          The number of chars in the buffer. 缓冲中的字符数。  Fields inherited from class java.io.Writerlock  Constructor SummaryCharArrayWriter()
          Creates a new CharArrayWriter. 创建一个CharArrayWriter。CharArrayWriter(int initialSize)
          Creates a new CharArrayWriter with the specified initial size. 创建一个指定初始大小的CharArrayWriter。  Method Summary voidclose()
          Close the stream. 关闭流。 voidflush()
          Flush the stream. 刷新流。 voidreset()
          Resets the buffer so that you can use it again without throwing away the already allocated buffer. 重置缓冲，可以使你再次使用，而不用抛出已分配的缓冲。 intsize()
          Returns the current size of the buffer. 返回缓冲的当前大小。 char[]toCharArray()
          Returns a copy of the input data. 返回输入数据的拷贝。 StringtoString()
          Converts input data to a string. 将输入数据转换成字符串。 voidwrite(char[] c, int off, int len)
          Writes characters to the buffer. 向缓冲写入字符。 voidwrite(int c)
          Writes a character to the buffer. 向缓冲写入一个字符。 voidwrite(String str, int off, int len)
          Write a portion of a string to the buffer. 向缓冲写入一段字符串。 voidwriteTo(Writer out)
          Writes the contents of the buffer to another character stream. 将缓冲的内容写入另一个字符流。  Methods inherited from class java.io.Writerwrite, write  Methods inherited from class java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait 

Field Detail

buf

protected char[] buf

The buffer where data is stored. 数据存入的缓冲。

---

count

protected int count

The number of chars in the buffer. 缓冲中的字符数。

Constructor Detail

CharArrayWriter

public CharArrayWriter()

Creates a new CharArrayWriter. 创建一个CharArrayWriter。

---

CharArrayWriter

public CharArrayWriter(int initialSize)

Creates a new CharArrayWriter with the specified initial size. 创建一个指定初始大小的CharArrayWriter。

Parameters:

initialSize - an int specifying the initial buffer size. 指定初始缓冲大小的int值。

Throws:

IllegalArgumentException - if initialSize is negative 如果initialSize为负时抛出

Method Detail

write

public void write(int c)

Writes a character to the buffer. 向缓冲写入一个字符。

Overrides:

write in class Writer

Parameters:

c - int specifying a character to be written. 指定被写入字符的int值

---

write

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

Writes characters to the buffer. 向缓冲写入字符。

Specified by:

write in class Writer

Parameters:

c - the data to be written 写入的数据

off - the start offset in the data 数据的起始偏移

len - the number of chars that are written 写入的字符数

---

write

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

Write a portion of a string to the buffer. 向缓冲写入一段字符串。

Overrides:

write in class Writer

Parameters:

str - String to be written from 被写入的字符串

off - Offset from which to start reading characters 开始读取字符的偏移位置

len - Number of characters to be written 写入的字符数

---

writeTo

public void writeTo(Writer out)             throws IOException

Writes the contents of the buffer to another character stream. 将缓冲的内容写入另一个字符流。

Parameters:

out - the output stream to write to 写入的输出流

Throws:

IOException - If an I/O error occurs. 如果I/O错误发生时抛出。

---

reset

public void reset()

Resets the buffer so that you can use it again without throwing away the already allocated buffer. 重置缓冲，可以使你再次使用，而不用抛出已分配的缓冲。

---

toCharArray

public char[] toCharArray()

Returns a copy of the input data. 返回输入数据的拷贝。

Returns:

an array of chars copied from the input data. 从输出数据拷贝的字符数组。

---

size

public int size()

Returns the current size of the buffer. 返回缓冲的当前大小。

Returns:

an int representing the current size of the buffer. 表示缓冲当前大小的int值。

---

toString

public String toString()

Converts input data to a string. 将输入数据转换成字符串。

Overrides:

toString in class Object

Returns:

the string. 字符串。

---

flush

public void flush()

Flush the stream. 刷新流。

Specified by:

flush in class Writer

---

close

public void close()

Close the stream. This method does not release the buffer, since its contents might still be required. 关闭流。该方法不释放缓冲，因为它的内容可能仍有需要。

Specified by:

close in class Writer

---

Overview Package  Class Use Tree Deprecated Index Help Java^TM 2 Platform
Std. Ed. v1.4.2  PREV CLASS   NEXT CLASSFRAMES    NO FRAMES     All Classes SUMMARY: NESTED | FIELD | CONSTR | METHODDETAIL: FIELD | CONSTR | METHOD

---

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.