java.io
클래스 StringWriter

java.lang.Object 
  java.io.Writer 
      java.io.StringWriter

모든 구현된 인터페이스:

Closeable , Flushable , Appendable

public class StringWriter
extends Writer 

출력을 캐릭터 라인 버퍼에 모으는 문자 스트림입니다. 이 캐릭터 라인 버퍼를 사용해 캐릭터 라인을 구축합니다.

StringWriter 를 닫아도, 무슨 영향도 없습니다. IOException 를 생성하지 않고 스트림이 닫혀진 후에, 이 클래스의 메소드를 호출할 수가 있습니다.

도입된 버젼:

JDK1. 1

필드의 개요

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

lock

생성자 의 개요

StringWriter ()
디폴트의 초기 캐릭터 라인 버퍼 사이즈를 사용해, 새로운 캐릭터 라인 라이터를 작성합니다.

StringWriter (int initialSize)
지정된 초기 캐릭터 라인 버퍼 사이즈를 사용해, 새로운 캐릭터 라인 라이터를 작성합니다.

메소드의 개요

StringWriter	append (char c) 지정된 문자를 이 라이터에 추가합니다.
StringWriter	append (CharSequence csq) 지정된 문자 순서를 이 라이터에 추가합니다.
StringWriter	append (CharSequence csq, int start, int end) 지정된 문자 순서의 서브 순서를 이 라이터에 추가합니다.
void	close () StringWriter 를 닫아도, 무슨 영향도 없습니다.
void	flush () 스트림을 플래시 합니다.
StringBuffer	getBuffer () 캐릭터 라인 버퍼 그 자체를 돌려줍니다.
String	toString () 버퍼의 현재의 값을 캐릭터 라인으로서 돌려줍니다.
void	write (char[] cbuf, int off, int len) 문자의 배열의 일부를 기입합니다.
void	write (int c) 단일의 문자를 기입합니다.
void	write (String str) 캐릭터 라인을 기입합니다.
void	write (String str, int off, int len) 캐릭터 라인의 일부를 기입합니다.

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

write

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

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

생성자 의 상세

StringWriter

public StringWriter()

디폴트의 초기 캐릭터 라인 버퍼 사이즈를 사용해, 새로운 캐릭터 라인 라이터를 작성합니다.

StringWriter

public StringWriter(int initialSize)

지정된 초기 캐릭터 라인 버퍼 사이즈를 사용해, 새로운 캐릭터 라인 라이터를 작성합니다.

파라미터:

initialSize - 이 버퍼가 자동적으로 확장되기 전에 이 버퍼에 들어가는 char 치의 수

예외:

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

메소드의 상세

write

public void write(int c)

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

오버라이드(override):

클래스 Writer 내의 write

파라미터:

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

write

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

문자의 배열의 일부를 기입합니다.

정의:

클래스 Writer 내의 write

파라미터:

cbuf - 문자의 배열

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

len - 기입하는 문자수

write

public void write(String  str)

캐릭터 라인을 기입합니다.

오버라이드(override):

클래스 Writer 내의 write

파라미터:

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

write

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

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

오버라이드(override):

클래스 Writer 내의 write

파라미터:

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

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

len - 기입하는 문자수

append

public StringWriter  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 StringWriter  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 StringWriter  append(char c)

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

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

out.write(c) 

정의:

인터페이스 Appendable 내의 append

오버라이드(override):

클래스 Writer 내의 append

파라미터:

c - 추가하는 16 비트 문자

반환값:

이 라이터

도입된 버젼:

1.5

toString

public String  toString()

버퍼의 현재의 값을 캐릭터 라인으로서 돌려줍니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 객체의 캐릭터 라인 표현

getBuffer

public StringBuffer  getBuffer()

캐릭터 라인 버퍼 그 자체를 돌려줍니다.

반환값:

현재의 버퍼치를 보관 유지하는 StringBuffer

flush

public void flush()

스트림을 플래시 합니다.

정의:

인터페이스 Flushable 내의 flush

정의:

클래스 Writer 내의 flush

close

public void close()
           throws IOException 

StringWriter 를 닫아도, 무슨 영향도 없습니다. IOException 를 생성하지 않고 스트림이 닫혀진 후에, 이 클래스의 메소드를 호출할 수가 있습니다.

정의:

인터페이스 Closeable 내의 close

정의:

클래스 Writer 내의 close

예외:

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