java.io
클래스 PushbackReader

java.lang.Object 
  java.io.Reader 
      java.io.FilterReader 
          java.io.PushbackReader

모든 구현된 인터페이스:

Closeable , Readable

public class PushbackReader
extends FilterReader 

문자를 스트림에 push back(되밀치는) 할 수 있는 문자 스트림 리더입니다.

도입된 버젼:

JDK1. 1

필드의 개요

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

in

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

lock

생성자 의 개요

PushbackReader (Reader in)
1 문자 분의 push back(되밀치는) 버퍼를 가지는, 새로운 push back(되밀치는) 리더를 작성합니다.

PushbackReader (Reader in, int size)
지정된 사이즈의 push back(되밀치는) 버퍼를 가지는, 새로운 push back(되밀치는) 리더를 작성합니다.

메소드의 개요

void	close () 스트림을 닫아, 거기에 관련하는 모든 system resource를 해제합니다.
void	mark (int readAheadLimit) 스트림의 현재 위치에 마크를 설정합니다.
boolean	markSupported () 이 스트림이 mark() 오퍼레이션을 지원할지 어떨지, 지원하지 않는 것은 어떤 것인가를 조사합니다.
int	read () 단일의 문자를 읽어들입니다.
int	read (char[] cbuf, int off, int len) 배열의 일부에 문자를 읽어들입니다.
boolean	ready () 이 스트림이 읽어들여 가능한가 어떤가를 판정합니다.
void	reset () 스트림을 리셋 합니다.
long	skip (long n) 문자를 스킵 합니다.
void	unread (char[] cbuf) push back(되밀치는) 버퍼의 선두에 문자 배열을 카피하는 것에 의해, 문자 배열을 push back(되밀치는) 합니다.
void	unread (char[] cbuf, int off, int len) push back(되밀치는) 버퍼의 선두에 문자 배열의 일부를 카피하는 것에 의해, 그러한 문자를 push back(되밀치는) 합니다.
void	unread (int c) push back(되밀치는) 버퍼의 선두에 1 문자를 카피하는 것에 의해, 그 문자를 push back(되밀치는) 합니다.

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

read , read

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

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

생성자 의 상세

PushbackReader

public PushbackReader(Reader  in,
                      int size)

지정된 사이즈의 push back(되밀치는) 버퍼를 가지는, 새로운 push back(되밀치는) 리더를 작성합니다.

파라미터:

in - 문자의 read원의 리더

size - push back(되밀치는) 버퍼의 사이즈

예외:

IllegalArgumentException - 사이즈가 0 이하의 경우

PushbackReader

public PushbackReader(Reader  in)

1 문자 분의 push back(되밀치는) 버퍼를 가지는, 새로운 push back(되밀치는) 리더를 작성합니다.

파라미터:

in - 문자의 read원의 리더

메소드의 상세

read

public int read()
         throws IOException 

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

오버라이드(override):

클래스 FilterReader 내의 read

반환값:

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

예외:

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

read

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

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

오버라이드(override):

클래스 FilterReader 내의 read

파라미터:

cbuf - 전송처 버퍼

off - 문자의 기입 개시 오프셋(offset)

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

반환값:

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

예외:

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

unread

public void unread(int c)
            throws IOException 

push back(되밀치는) 버퍼의 선두에 1 문자를 카피하는 것에 의해, 그 문자를 push back(되밀치는) 합니다. 이 메소드가 복귀하면(자), 다음에 읽히는 문자는 값 (char) c 를 가집니다.

파라미터:

c - push back(되밀치는) 되는 문자를 나타내는 int 치

예외:

IOException - push back(되밀치는) 버퍼가 가득한 경우, 또는 다른 입출력 에러가 발생했을 경우

unread

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

push back(되밀치는) 버퍼의 선두에 문자 배열의 일부를 카피하는 것에 의해, 그러한 문자를 push back(되밀치는) 합니다. 이 메소드가 복귀하면(자), 다음에 읽히는 문자는 값 cbuf[off] 를 가져, 그 다음의 문자는 값 cbuf[off+1] 를 가집니다. 그 이후도 이와 같이 계속됩니다.

파라미터:

cbuf - 문자 배열

off - 문자의 push back(되밀치는) 개시 오프셋(offset)

len - push back(되밀치는) 하는 문자수

예외:

IOException - push back(되밀치는) 버퍼에 충분한 스페이스가 없는 경우, 또는 다른 입출력 에러가 발생했을 경우

unread

public void unread(char[] cbuf)
            throws IOException 

push back(되밀치는) 버퍼의 선두에 문자 배열을 카피하는 것에 의해, 문자 배열을 push back(되밀치는) 합니다. 이 메소드가 복귀하면(자), 다음에 읽히는 문자는 값 cbuf[0] 을 가져, 그 다음의 문자는 값 cbuf[1] 을 가집니다. 그 이후도 이와 같이 계속됩니다.

파라미터:

cbuf - push back(되밀치는) 하는 문자 배열

예외:

IOException - push back(되밀치는) 버퍼에 충분한 스페이스가 없는 경우, 또는 다른 입출력 에러가 발생했을 경우

ready

public boolean ready()
              throws IOException 

이 스트림이 읽어들여 가능한가 어떤가를 판정합니다.

오버라이드(override):

클래스 FilterReader 내의 ready

반환값:

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

예외:

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

mark

public void mark(int readAheadLimit)
          throws IOException 

스트림의 현재 위치에 마크를 설정합니다. PushbackReader 클래스의 mark 는 항상 예외를 throw 합니다.

오버라이드(override):

클래스 FilterReader 내의 mark

파라미터:

readAheadLimit - 마크를 보관 유지하면서 읽어들일 수가 있는 문자수의 상한. 이 수의 문자를 읽어들인 후에 스트림을 리셋 하려고 하면(자) 실패하는 경우가 있다

예외:

IOException - mark 메소드는 지원되어 있지 않기 때문에, 항상 throw 된다

reset

public void reset()
           throws IOException 

스트림을 리셋 합니다. PushbackReader 의 reset 메소드는 항상 예외를 throw 합니다.

오버라이드(override):

클래스 FilterReader 내의 reset

예외:

IOException - reset 메소드는 지원되어 있지 않기 때문에, 항상 throw 된다

markSupported

public boolean markSupported()

이 스트림이 mark() 오퍼레이션을 지원할지 어떨지, 지원하지 않는 것은 어떤 것인가를 조사합니다.

오버라이드(override):

클래스 FilterReader 내의 markSupported

반환값:

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

close

public void close()
           throws IOException 

스트림을 닫아, 거기에 관련하는 모든 system resource를 해제합니다. 스트림을 닫은 뒤에, 또한 read(), unread(), ready(), 또는 skip()를 호출하면(자), IOException 가 throw 됩니다. 벌써 닫혀지고 있는 스트림을 닫아도, 무슨 영향도 없습니다.

정의:

인터페이스 Closeable 내의 close

오버라이드(override):

클래스 FilterReader 내의 close

예외:

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

skip

public long skip(long n)
          throws IOException 

문자를 스킵 합니다. 이 메소드는, 문자가 읽히는지, 입출력 에러가 발생하든가, 혹은 스트림의 마지막에 이를 때까지 블록 합니다.

오버라이드(override):

클래스 FilterReader 내의 skip

파라미터:

n - 스킵 하는 문자수

반환값:

실제로 스킵 한 문자수

예외:

IllegalArgumentException - n 가 0 보다 작은 값의 경우

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