java.io
클래스 BufferedReader

java.lang.Object 
  java.io.Reader 
      java.io.BufferedReader

모든 구현된 인터페이스:

Closeable, Readable

알려진 직계 서브 클래스:

LineNumberReader

public class BufferedReader
extends Reader 

문자, 배열, 행을 버퍼링 하는 것에의해 문자형 입력 스트림로부터 텍스트를 효율 좋게 읽어들입니다.

버퍼의 사이즈는 기본값 대로 하는 일도, 특정의 값을 지정할 수도 있습니다. 기본값는 보통 의 사용법으로는 충분한 크출력니다.

일반적으로 Reader에 대해서 읽기 요구가 나오면, 거기에 대응하는 기본이 되는 문자형 스트림 또는 바이트 스트림에의 읽기 요구가 발행됩니다. 이 때문에 FileReader 나 InputStreamReader와 같이 read() 조작의 효율의 좋지 않는 Reader 에서는 그 주위를 BufferedReader 로감싸는 것을 추천합니다. 예를 들어 다음의 예는 지정된 파일로부터의 입력을 버퍼 합니다.

 BufferedReader in
   = new BufferedReader(new FileReader("foo.in"));
 

버퍼링 하지 않고 read(), readLine()를 사용하면, 호출할 것에 파일로부터 바이트를 읽기, 문자형으로 변환해, 그때마다 복귀하므로 매우 효율이 나빠집니다.

텍스트 입력에 대해서 DataInputStream를 사용하는 프로그램은 각 DataInputStream를 적절한 BufferedReader 로 바꾸어 넣는 것에 의해 지역 대응할 수 있습니다 .

도입된 버전 :

JDK1. 1

관련 항목:

FileReader, InputStreamReader

필드 개요

클래스 java.io. Reader 로부터 상속된 필드

lock

생성자 개요

BufferedReader (Reader in)
디폴트 사이즈의 버퍼로 버퍼링 된, 문자형 입력 스트림을 작성합니다.

BufferedReader (Reader in, int sz)
지정된 사이즈의 버퍼로 버퍼링 된, 문자형 입력 스트림을 작성합니다.

메서드 개요

void	close () 스트림을 닫습니다.
void	mark (int readAheadLimit) 스트림의 현재 위치에 마크를 설정합니다.
boolean	markSupported () 이 스트림이, 실행하는 mark() 조작을 지원할지 어떨지를 통지합니다.
int	read () 단일의 문자를 읽어들입니다.
int	read (char[] cbuf, int off, int len) 배열의 일부에 문자를 읽어들입니다.
String	readLine () 1 행의 텍스트를 읽어들입니다.
boolean	ready () 스트림이 읽기 가능한가 어떤가를 리턴합니다.
void	reset () 스트림을 가장 새로운 마크 위치에 리셋 합니다.
long	skip (long n) 문자를 스킵 합니다.

클래스 java.io. Reader 로부터 상속된 메서드

read, read

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

BufferedReader

public BufferedReader(Reader  in,
                      int sz)

지정된 사이즈의 버퍼로 버퍼링 된, 문자형 입력 스트림을 작성합니다.

파라미터:

in - Reader

sz - 입력 버퍼의 사이즈

예외:

IllegalArgumentException - sz가 0 아래의 경우

BufferedReader

public BufferedReader(Reader  in)

디폴트 사이즈의 버퍼로 버퍼링 된, 문자형 입력 스트림을 작성합니다.

파라미터:

in - Reader

메서드의 상세

read

public int read()
         throws IOException 

단일의 문자를 읽어들입니다.

오버라이드(override):

클래스 Reader 내의 read

반환값:

0 ~ 65535 (0x00-0xffff)의 범위의 정수로서의, 읽힌 문자. 스트림의 마지막에 이르렀을 경우는 -1

예외:

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

read

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

배열의 일부에 문자를 읽어들입니다.

이 메서드는 Reader 클래스의 대응하는 read 메서드의 범용 규약을 구현합니다. 보다 편리하게, 이 메서드는 기본이 되는 스트림의 read 메서드를 반복해 호출해, 가능한 한 많은 문자수를 읽어들이려고 합니다. 이 read 반복은 아래의 조건의 1개가 true가 될 때까지 행해집니다.

• 지정된 문자수가 읽혔다
• 기본이 되는 스트림의 read 메서드가 파일의 마지막을 나타내는 -1을 돌려주었다
• 기본이 되는 스트림의 ready 메서드가 그 이상의 입력 요구가 블록 되는 것을 나타내는 false를 돌려주었다

기본이 되는 스트림의 최초의 read가 파일의 마지막을 나타내는 -1을 돌려주면, 이 메서드는 -1을 리턴합니다. 그렇지 않은 경우, 이 메서드는 실제로 읽힌 문자수를 리턴합니다.

이 클래스의 서브 클래스는 같은 방법으로 가능한 한 많은 문자수를 읽어들이는 것이 추천 됩니다. 다만, 이것은 필수가 아닙니다.

보통 이 메서드는 이 스트림의 문자 버퍼로부터 문자를 취득해, 필요에 따라서 기본이 되는 스트림로부터 그 버퍼를 묻습니다. 그러나, 버퍼가 비어있어 마크가 무효로 요구된 길이가 버퍼와 같은 크기 이상의 경우, 이 메서드는 기본이 되는 스트림로부터, 지정된 배열에 직접 문자를 읽어들입니다. 이 때문에 여분의 BufferedReader가 데이터를 불필요하게 카피하는 일이 없습니다.

정의:

클래스 Reader 내의 read

파라미터:

cbuf - 전송처 버퍼

off - 문자의 포함 개시 오프셋(offset)

len - 읽어들이는 문자의 최대수

반환값:

읽힌 문자수. 스트림의 마지막에 이르렀을 경우는 -1

예외:

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

readLine

public String  readLine()
                throws IOException 

1 행의 텍스트를 읽어들입니다. 1 행의 종단은 개행 ( 「\n」)인가 복귀 ( 「\r」), 또는 복행으로 거기에 계속되는 개행의 어떤 것인가로 인식됩니다.

반환값:

행의 내용을 포함한 캐릭터 라인, 다만 행의 종단 문자는 포함하지 않는다. 스트림의 마지막에 이르고 있는 경우는 null

예외:

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

skip

public long skip(long n)
          throws IOException 

문자를 스킵 합니다.

오버라이드(override):

클래스 Reader 내의 skip

파라미터:

n - 스킵 하는 문자수

반환값:

실제로 스킵 한 문자수

예외:

IllegalArgumentException - n가 잘못된 값 의 경우

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

ready

public boolean ready()
              throws IOException 

스트림이 읽기 가능한가 어떤가를 리턴합니다. 버퍼링 된 문자형 스트림은 공백이 아닌지, 또는 기본이 되는 문자형 스트림이 읽기 가능하다라고 나무에 읽기 가능합니다.

오버라이드(override):

클래스 Reader 내의 ready

반환값:

다음의 read()가 입력을 블록 하지 않는 것이 확실한 경우는 true, 그렇지 않은 경우는 false. false가 돌려주고져도, 다음의 read가 확실히 블록 한다는 것이 아니다

예외:

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

markSupported

public boolean markSupported()

이 스트림이, 실행하는 mark() 조작을 지원할지 어떨지를 통지합니다.

오버라이드(override):

클래스 Reader 내의 markSupported

반환값:

이 스트림이 mark 오퍼레이션을 지원하는 경우에 한정해 true

mark

public void mark(int readAheadLimit)
          throws IOException 

스트림의 현재 위치에 마크를 설정합니다. 이후 reset()를 호출하면, 스트림의 위값이 이 정도치로 변경됩니다.

오버라이드(override):

클래스 Reader 내의 mark

파라미터:

readAheadLimit - 마크를 보관 유지하면서 읽어들일 수 있는 문자수의 상한. 이 수의 문자를 읽어들인 후에 스트림을 리셋 하려고 하면 실패하는 경우가 있다. 입력 버퍼의 사이즈보다 큰 한계치를 지정하면, 그 사이즈가 한계보다 작지 않은 새로운 버퍼를 할당할 수 있다. 그 때문에 큰 값은 주의해 사용할 필요가 있다

예외:

IllegalArgumentException - readAheadLimit가 잘못된 값 의 경우

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

reset

public void reset()
           throws IOException 

스트림을 가장 새로운 마크 위치에 리셋 합니다.

오버라이드(override):

클래스 Reader 내의 reset

예외:

IOException - 스트림에 마크를 설정할 수 없었던 경우, 또는 마크가 무효가 되었을 경우

close

public void close()
           throws IOException 

스트림을 닫습니다.

정의:

인터페이스 Closeable 내의 close

정의:

클래스 Reader 내의 close

예외:

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