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) 지정된 문자 순서의 서브 순서를 이 Writer에 추가합니다.
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 - 버퍼의 초기 사이즈를 지정하는 int

메서드의 상세

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인 경우는 이 Writer에 「null」라고 하는 4 문자가 추가된다

반환값:

이 라이터

도입된 버전 :

1.5

append

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

지정된 문자 순서의 서브 순서를 이 Writer에 추가합니다.

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

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

정의:

인터페이스 Appendable 내의 append

오버라이드(override):

클래스 Writer 내의 append

파라미터:

csq - 서브 순서의 추가원의 문자 순서. csq가 null 이면, 문자는 csq에 「null」라고 하는 4 문자가 포함되어 있는 것과 같게 추가되는

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

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

반환값:

이 라이터

예외:

IndexOutOfBoundsException - start 또는 end가 잘못된 값 의 경우, 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 - 입출력 에러가 발생했을 경우