BufferedWriter (Java Platform SE 6) - xrath.com 에서 번역됨

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

## 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` - 입출력 에러가 발생했을 경우

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.