java.io
클래스 BufferedWriter

java.lang.Object 
  |
  +--java.io.Writer 
        |
        +--java.io.BufferedWriter

public class BufferedWriter

extends Writer

캐릭터를 버퍼링 하는 것에 의해, 캐릭터, 배열, 또는 캐릭터 라인을 효율 좋게 캐릭터형 출력 스트림에 기입합니다.

버퍼의 사이즈는 디폴트 값대로 하는 일도, 특정의 값을 지정할 수도 있습니다. 디폴트 값은 통상의 사용법으로는 충분한 크기입니다.

시스템 프로퍼티의 line.separator 로 정의되는 행 단락 캐릭터는 플랫폼에 의존하기 위해(때문에), newLine() 메소드가 제공되고 있습니다. 모든 플랫폼이 개행 캐릭터 ('\n')로 행을 종단 시키는 것은 아니기 때문에, 개행 캐릭터를 직접 기입하는 것보다도, 이 메소드를 호출해 행을 종료시키는 것을 추천합니다.

일반적으로, Writer 는 그 출력을 즉시 기본이 되는 캐릭터형 스트림 또는 바이트 스트림에 송신합니다. prompt 출력을 필요로 하는 경우 이외에서는 FileWriter 나 OutputStreamWriter 와 같은 Writer 로부터 직접 write() 오퍼레이션을 호출하는 것은 효율이 나쁘기 때문에, BufferedWriter 로 랩 하는 것을 추천합니다. 예를 들어, 다음의 예는 PrintWriter 의 파일에의 출력을 버퍼링 합니다.

 PrintWriter out
   = new PrintWriter(new BufferedWriter(new FileWriter("foo.out")));
 

버퍼링 하지 않는 경우는 print() 메소드를 호출할 때마다 캐릭터를 바이트로 변환해 즉시 파일에 기입하므로, 효율이 매우 나빠집니다.

도입된 버젼:

JDK1. 1

관련 항목:

PrintWriter , FileWriter , OutputStreamWriter

필드의 개요

클래스 java.io. Writer 에서 상속받은 필드

lock

생성자의 개요

BufferedWriter (Writer out)
디폴트 사이즈의 출력 버퍼로 버퍼링 된, 캐릭터형 출력 스트림을 작성합니다.

BufferedWriter (Writer out, int sz)
지정된 사이즈의 출력 버퍼로 버퍼링 된, 캐릭터형 출력 스트림을 새롭게 작성합니다.

메소드의 개요

void	close () 스트림을 닫습니다.
void	flush () 스트림을 플래시 합니다.
void	newLine () 행 단락 캐릭터를 기입합니다.
void	write (char[] cbuf, int off, int len) 캐릭터의 배열의 일부를 기입합니다.
void	write (int c) 단일의 캐릭터를 기입합니다.
void	write (String s, int off, int len) String 의 일부를 기입합니다.

클래스 java.io. Writer 에서 상속받은 메소드

write , write

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

BufferedWriter

public BufferedWriter(Writer  out)

디폴트 사이즈의 출력 버퍼로 버퍼링 된, 캐릭터형 출력 스트림을 작성합니다.

파라미터:

out - Writer

BufferedWriter

public BufferedWriter(Writer  out,
                      int sz)

지정된 사이즈의 출력 버퍼로 버퍼링 된, 캐릭터형 출력 스트림을 새롭게 작성합니다.

파라미터:

out - Writer

sz - 출력 버퍼의 사이즈. 정의 정수

예외:

IllegalArgumentException - sz 가 0 이하의 경우

메소드의 상세

write

public void write(int c)
           throws IOException 

단일의 캐릭터를 기입합니다.

오버라이드(override):

클래스 Writer 내의 write

파라미터:

c - 기입하는 캐릭터를 지정하는 int

예외:

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

write

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

캐릭터의 배열의 일부를 기입합니다.

통상 이 메소드는 지정된 배열로부터 이 스트림의 버퍼에 캐릭터를 저장해, 필요에 따라서 기본이 되는 스트림에 버퍼를 플래시 합니다. 그러나, 요구된 길이가 이 스트림의 버퍼와 같은 크기 이상의 경우, 이 메소드는 버퍼를 플래시 해, 그 캐릭터를 직접 기본이 되는 스트림에 기입합니다. 이 때문에, 여분의 BufferedWriter 가, 데이터를 불필요하게 카피하는 일이 없습니다.

정의:

클래스 Writer 내의 write

파라미터:

cbuf - 캐릭터형 배열

off - 캐릭터의 read 개시 오프셋(offset)

len - 기입하는 캐릭터수

예외:

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

write

public void write(String  s,
                  int off,
                  int len)
           throws IOException 

String 의 일부를 기입합니다.

오버라이드(override):

클래스 Writer 내의 write

파라미터:

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

off - 캐릭터의 read 개시 오프셋(offset)

len - 기입하는 캐릭터수

예외:

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

newLine

public void newLine()
             throws IOException 

행 단락 캐릭터를 기입합니다. 행 단락 캐릭터는 시스템의 line.separator 프로퍼티로 정의되어 단일의 개행 캐릭터 ('\n')라고는 할 수 없습니다.

예외:

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

flush

public void flush()
           throws IOException 

스트림을 플래시 합니다.

정의:

클래스 Writer 내의 flush

예외:

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

close

public void close()
           throws IOException 

스트림을 닫습니다.

정의:

클래스 Writer 내의 close

예외:

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