java.io
클래스 BufferedWriter

java.lang.Object 
  java.io.Writer 
      java.io.BufferedWriter

모든 구현된 인터페이스:

Closeable , Flushable , Appendable

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 로부터 상속된 메소드

append , append , append , 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 의 일부를 기입합니다.

len 파라미터의 값이 부의 경우는, 문자가 기입해지지 않습니다. 이것은,IndexOutOfBoundsException 가 throw 될 필요가 있는 슈퍼 클래스에서의 이 메소드의 스펙과 다릅니다.

오버라이드(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 

스트림을 플래시 합니다.

정의:

인터페이스 Flushable 내의 flush

정의:

클래스 Writer 내의 flush

예외:

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

close

public void close()
           throws IOException 

클래스 Writer 의 기술:

스트림을 최초로 플래시 해, 닫습니다. 스트림이 닫혀진 뒤에 write() 또는 flush()를 호출하면(자), IOException 가 throw 됩니다. 벌써 닫혀지고 있는 스트림을 닫아도, 무슨 영향도 없습니다.

정의:

인터페이스 Closeable 내의 close

정의:

클래스 Writer 내의 close

예외:

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