java.io
클래스 CharArrayWriter

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

모든 구현된 인터페이스:

Closeable , Flushable , Appendable

public class CharArrayWriter
extends Writer 

Writer 로서 사용하는 문자 버퍼를 구현합니다. 스트림에 문자가 기입해지는에 따라, 버퍼는 자동적으로 커집니다. toCharArray()나 toString()를 사용해 데이타를 뽑기 시작할 수가 있습니다.

주:이 클래스에서 close()를 호출해도, 아무것도 변화는 없습니다. 스트림을 닫은 뒤에 이 클래스의 메소드를 호출해도, IOException 는 생성되지 않습니다.

도입된 버젼:

JDK1. 1

필드의 개요

protected char[]	buf 데이터가 포함되는 버퍼입니다.
protected int	count 버퍼안의 문자수입니다.

클래스 java.io. Writer 로부터 상속된 필드

lock

생성자 의 개요

CharArrayWriter ()
CharArrayWriter 를 새롭게 작성합니다.

CharArrayWriter (int initialSize)
지정된 초기 사이즈로 CharArrayWriter 를 새롭게 작성합니다.

메소드의 개요

CharArrayWriter	append (char c) 이 라이터로 지정된 문자를 추가합니다.
CharArrayWriter	append (CharSequence csq) 이 라이터로 지정된 문자 순서를 추가합니다.
CharArrayWriter	append (CharSequence csq, int start, int end) 이 라이터로 지정된 문자 순서의 서브 순서를 추가합니다.
void	close () 스트림을 닫습니다.
void	flush () 스트림을 플래시 합니다.
void	reset () 메모리 할당하고 끝난 버퍼를 폐기하지 않고 재사용할 수 있도록(듯이), 버퍼를 리셋 합니다.
int	size () 버퍼의 현재의 사이즈를 돌려줍니다.
char[]	toCharArray () 입력 데이터의 카피를 돌려줍니다.
String	toString () 입력 데이터를 캐릭터 라인으로 변환합니다.
void	write (char[] c, int off, int len) 버퍼에 문자를 기입합니다.
void	write (int c) 버퍼에 단일의 문자를 기입합니다.
void	write (String str, int off, int len) 캐릭터 라인의 일부를 버퍼에 기입합니다.
void	writeTo (Writer out) 버퍼의 내용을 다른 문자 스트림에 기입합니다.

클래스 java.io. Writer 로부터 상속된 메소드

write , write

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait

필드의 상세

buf

protected char[] buf

데이터가 포함되는 버퍼입니다.

count

protected int count

버퍼안의 문자수입니다.

생성자 의 상세

CharArrayWriter

public CharArrayWriter()

CharArrayWriter 를 새롭게 작성합니다.

CharArrayWriter

public CharArrayWriter(int initialSize)

지정된 초기 사이즈로 CharArrayWriter 를 새롭게 작성합니다.

파라미터:

initialSize - 버퍼의 초기 사이즈를 지정하는 int

예외:

IllegalArgumentException - initialSize 가 0 보다 작은 값의 경우

메소드의 상세

write

public void write(int c)

버퍼에 단일의 문자를 기입합니다.

오버라이드(override):

클래스 Writer 내의 write

파라미터:

c - 기입하는 문자를 지정하는 int

write

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

버퍼에 문자를 기입합니다.

정의:

클래스 Writer 내의 write

파라미터:

c - 기입해지는 데이터

off - 데이터의 개시 오프셋(offset)

len - 기입하는 문자수

write

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

캐릭터 라인의 일부를 버퍼에 기입합니다.

오버라이드(override):

클래스 Writer 내의 write

파라미터:

str - 기입해지는 캐릭터 라인

off - 문자의 read 개시 오프셋(offset)

len - 기입하는 문자수

writeTo

public void writeTo(Writer  out)
             throws IOException 

버퍼의 내용을 다른 문자 스트림에 기입합니다.

파라미터:

out - 기입처의 출력 스트림

예외:

IOException - 입출력 에러가 발생했을 경우

append

public CharArrayWriter  append(CharSequence  csq)

이 라이터로 지정된 문자 순서를 추가합니다.

이 메소드를 out.append(csq) 의 형식에서 호출했을 경우, 다음의 호출과 같은 결과를 얻을 수 있습니다.

out.write(csq.toString()) 

문자 순서 csq 의 toString 의 스펙에 따라서는, 그 순서 전체가 추가되지 않을 가능성도 있습니다. 예를 들어, 문자 버퍼의 toString 메소드를 호출했을 경우, 그 버퍼의 위치와 리밋트에 의해 정해지는 내용을 가지는 서브 순서가 돌려주어집니다.

정의:

인터페이스 Appendable 내의 append

오버라이드(override):

클래스 Writer 내의 append

파라미터:

csq - 추가되는 문자 순서. csq 가 null 의 경우는, 이 라이터에 「null」라고 하는 4 문자가 추가된다

반환값:

이 라이터

도입된 버젼:

1.5

append

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

이 라이터로 지정된 문자 순서의 서브 순서를 추가합니다.

이 메소드를 out.append(csq, start, end) (csq 는 null 가 아니다)의 형식에서 호출했을 경우, 다음의 호출과 같은 결과를 얻을 수 있습니다.

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

정의:

인터페이스 Appendable 내의 append

오버라이드(override):

클래스 Writer 내의 append

파라미터:

csq - 문자 서브 순서의 추가원이 되는 문자 순서. csq 가 null 의 경우,csq 에 「null」의 4 문자가 포함되는것 같이 문자가 추가되는

start - 문자 서브 순서의 최초의 문자의 인덱스

end - 문자 서브 순서의 마지막 문자에 계속되는 문자의 인덱스

반환값:

이 라이터

예외:

IndexOutOfBoundsException - start 또는 end 가 0 보다 작은 값의 경우,start 가 end 보다 큰 경우, 또는 end 가 csq.length() 보다 큰 경우

도입된 버젼:

1.5

append

public CharArrayWriter  append(char c)

이 라이터로 지정된 문자를 추가합니다.

이 메소드를 out.append(c) 의 형식에서 호출했을 경우, 다음의 호출과 같은 결과를 얻을 수 있습니다.

out.write(c) 

정의:

인터페이스 Appendable 내의 append

오버라이드(override):

클래스 Writer 내의 append

파라미터:

c - 추가하는 16 비트 문자

반환값:

이 라이터

도입된 버젼:

1.5

reset

public void reset()

메모리 할당하고 끝난 버퍼를 폐기하지 않고 재사용할 수 있도록(듯이), 버퍼를 리셋 합니다.

toCharArray

public char[] toCharArray()

입력 데이터의 카피를 돌려줍니다.

반환값:

이 입력 데이터로부터 카피된 문자의 배열

size

public int size()

버퍼의 현재의 사이즈를 돌려줍니다.

반환값:

버퍼의 현재의 사이즈를 나타내는 int

toString

public String  toString()

입력 데이터를 캐릭터 라인으로 변환합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

캐릭터 라인

flush

public void flush()

스트림을 플래시 합니다.

정의:

인터페이스 Flushable 내의 flush

정의:

클래스 Writer 내의 flush

close

public void close()

스트림을 닫습니다. 이 메소드의 내용은 이후도 요구되므로, 버퍼는 해제되지 않습니다. 주:이 클래스의 이 메소드를 호출해도, 무슨 효과도 없습니다.

정의:

인터페이스 Closeable 내의 close

정의:

클래스 Writer 내의 close