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 

스트림을 닫습니다.

정의:

인터페이스 Closeable 내의 close

정의:

클래스 Writer 내의 close

예외:

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