java.io
클래스 BufferedReader

java.lang.Object 
  |
  +--java.io.Reader 
        |
        +--java.io.BufferedReader

직계의 기존의 서브 클래스:

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

클래스 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 

스트림을 닫습니다.

정의:

클래스 Reader 내의 close

예외:

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