java.io
클래스 PushbackInputStream

java.lang.Object 
  |
  +--java.io.InputStream 
        |
        +--java.io.FilterInputStream 
              |
              +--java.io.PushbackInputStream

public class PushbackInputStream

extends FilterInputStream

다른 입력 스트림에 기능을 추가합니다. 구체적으로는 1 바이트를 「이륙 시각의 연기」또는 「안리드」하는 기능입니다. 이것은 특정의 바이트치로 단락지어지는 부정수의 데이터 바이트를 읽어들이는 코드를 준비하면(자) 형편이 좋은 상황으로 도움이 됩니다. 그 단락의 바이트를 읽어들이면(자), 코드는 그것을 「안리드」할 수 있으므로, 입력 스트림의 다음의 read 오퍼레이션에서는 이륙 시각의 연기 된 그 바이트를 재차 읽어들이게 됩니다. 예를 들어, 식별자를 구성해 있는 캐릭터를 나타내는 일련의 바이트는 연산자 캐릭터를 나타내는 바이트로 끝납니다. 식별자를 1 개만 읽어들이는 작업을 가지는 메소드는 연산자를 검출할 때까지 읽어들여, 연산자를 이륙 시각의 연기 해 재차 읽어들일 수가 있습니다.

도입된 버젼:

JDK1. 0

필드의 개요

protected byte[]	buf 이륙 시각의 연기 버퍼입니다.
protected int	pos 이륙 시각의 연기 버퍼내의 다음의 바이트의 read 위치입니다.

클래스 java.io. FilterInputStream 에서 상속받은 필드

in

생성자의 개요

PushbackInputStream (InputStream in)
PushbackInputStream 를 작성해, 그 인수인 입력 스트림 in 를 나중에 사용하기 위해서(때문에) 보존합니다.

PushbackInputStream (InputStream in, int size)
지정된 size 의 이륙 시각의 연기 버퍼를 가지는 PushbackInputStream 를 작성해, 그 인수인 입력 스트림 in 를, 나중에 사용할 수 있게 보존합니다.

메소드의 개요

int	available () 블록 하지 않고 이 입력 스트림으로부터 읽어들일 수가 있는 바이트수를 돌려줍니다.
void	close () 이 입력 스트림을 닫아 그 스트림에 관련하는 모든 system resource를 해방합니다.
boolean	markSupported () 이 입력 스트림이,mark 메소드와 reset 메소드를 서포트하고 있을지 어떨지를 판정합니다.
int	read () 이 입력 스트림으로부터 , 데이터의 다음의 바이트를 읽어들입니다.
int	read (byte[] b, int off, int len) 이 입력 스트림으로부터 ,len 바이트까지의 데이터를 바이트의 배열에 읽어들입니다.
long	skip (long n) 이 입력 스트림으로부터 의 데이터를 n 바이트만 스킵 해 파기합니다.
void	unread (byte[] b) 이륙 시각의 연기 버퍼의 선두에 그 바이트의 배열을 카피해, 바이트의 배열을 이륙 시각의 연기 합니다.
void	unread (byte[] b, int off, int len) 이륙 시각의 연기 버퍼의 선두에 그 바이트의 배열의 일부를 카피해, 바이트의 배열의 일부를 이륙 시각의 연기 합니다.
void	unread (int b) 이륙 시각의 연기 버퍼의 선두에 그 바이트를 카피해, 1 바이트를 이륙 시각의 연기 합니다.

클래스 java.io. FilterInputStream 에서 상속받은 메소드

mark , read , reset

클래스 java.lang. Object 에서 상속받은 메소드

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

필드의 상세

buf

protected byte[] buf

이륙 시각의 연기 버퍼입니다.

도입된 버젼:

JDK1. 1

pos

protected int pos

이륙 시각의 연기 버퍼내의 다음의 바이트의 read 위치입니다. 버퍼가 비었을 경우,pos 는 buf.length 에 일치해, 버퍼가 가득한 경우,pos 는 제로에 일치합니다.

도입된 버젼:

JDK1. 1

생성자의 상세

PushbackInputStream

public PushbackInputStream(InputStream  in,
                           int size)

지정된 size 의 이륙 시각의 연기 버퍼를 가지는 PushbackInputStream 를 작성해, 그 인수인 입력 스트림 in 를, 나중에 사용할 수 있게 보존합니다. 초기 상태에서는 이륙 시각의 연기 된 바이트는 없습니다. pushBack 필드는 -1 에 초기화됩니다.

파라미터:

in - 바이트의 read원의 입력 스트림

size - 이륙 시각의 연기 버퍼의 사이즈

예외:

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

도입된 버젼:

JDK1. 1

PushbackInputStream

public PushbackInputStream(InputStream  in)

PushbackInputStream 를 작성해, 그 인수인 입력 스트림 in 를 나중에 사용하기 위해서(때문에) 보존합니다. 초기 상태에서는 이륙 시각의 연기 된 바이트는 없습니다. pushBack 필드는 -1 에 초기화됩니다.

파라미터:

in - 바이트의 read원의 입력 스트림

메소드의 상세

read

public int read()
         throws IOException 

이 입력 스트림으로부터 , 데이터의 다음의 바이트를 읽어들입니다. 그 바이트는 0 ~ 255 의 범위의 int 로서 돌려주어집니다. 스트림의 마지막에 이르러 바이트가 없는 경우는 값 -1 이 돌려주어집니다. 이 메소드는 입력 데이터가 읽히게 되는지 스트림의 마지막이 검출되는지 또는 예외가 슬로우 될 때까지 블록 합니다.

이 메소드는 마지막에 이륙 시각의 연기 된 바이트가 있는 경우에는 그것을 돌려줍니다. 그것이 없는 경우, 그 기본이 되는 입력 스트림의 read 메소드를 호출해 그 반환값을 돌려줍니다.

오버라이드(override):

클래스 FilterInputStream 내의 read

반환값:

데이터의 다음의 바이트. 스트림의 마지막에 이르렀을 경우는 -1

예외:

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

관련 항목:

InputStream.read()

read

public int read(byte[] b,
                int off,
                int len)
         throws IOException 

이 입력 스트림으로부터 ,len 바이트까지의 데이터를 바이트의 배열에 읽어들입니다. 이 메소드에서는 우선 이륙 시각의 연기 된 바이트가 있으면 그것을 읽어들입니다. 다음에, 읽힌 바이트가 len 바이트보다 적은 경우, 기본이 되는 입력 스트림으로부터 읽어들입니다. 이 메소드는 적어도 1 바이트를 입력할 수 있게 될 때까지 블록 합니다.

오버라이드(override):

클래스 FilterInputStream 내의 read

파라미터:

b - 데이터의 read처의 버퍼

off - 데이터의 개시 오프셋(offset)

len - 읽히는 최대 바이트수

반환값:

버퍼에 읽힌 바이트의 합계수. 스트림의 마지막에 이르러 데이터가 없는 경우는 -1

예외:

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

관련 항목:

InputStream.read(byte[], int, int)

unread

public void unread(int b)
            throws IOException 

이륙 시각의 연기 버퍼의 선두에 그 바이트를 카피해, 1 바이트를 이륙 시각의 연기 합니다. 이 메소드가 복귀하면(자), 읽어들이는 다음의 바이트는 값 (byte) b 를 가집니다.

파라미터:

b - 이륙 시각의 연기 되는 하위의 바이트를 가지는 int 치

예외:

IOException - 바이트에 대해서, 이륙 시각의 연기 버퍼에 충분한 스페이스가 없는 경우

unread

public void unread(byte[] b,
                   int off,
                   int len)
            throws IOException 

이륙 시각의 연기 버퍼의 선두에 그 바이트의 배열의 일부를 카피해, 바이트의 배열의 일부를 이륙 시각의 연기 합니다. 이 메소드가 복귀하면(자), 다음에 읽히는 바이트는 값 b[off], 그 다음의 바이트는 값 b[off+1] 와 값을 차례차례 보관 유지해 갈 것입니다.

파라미터:

b - 이륙 시각의 연기 하는 바이트의 배열

off - 데이터의 개시 오프셋(offset)

len - 이륙 시각의 연기 하는 바이트수

예외:

IOException - 지정된 바이트수에 대해서, 이륙 시각의 연기 버퍼에 충분한 스페이스가 없는 경우

도입된 버젼:

JDK1. 1

unread

public void unread(byte[] b)
            throws IOException 

이륙 시각의 연기 버퍼의 선두에 그 바이트의 배열을 카피해, 바이트의 배열을 이륙 시각의 연기 합니다. 이 메소드가 복귀하면(자), 다음에 읽히는 바이트는 값 b[0], 그 다음의 바이트는 값 b[1] 과 값을 차례차례 보관 유지해 갈 것입니다.

파라미터:

b - 이륙 시각의 연기 하는 바이트의 배열

예외:

IOException - 지정된 바이트수에 대해서, 이륙 시각의 연기 버퍼에 충분한 스페이스가 없는 경우

도입된 버젼:

JDK1. 1

available

public int available()
              throws IOException 

블록 하지 않고 이 입력 스트림으로부터 읽어들일 수가 있는 바이트수를 돌려줍니다. 이 메소드는 기본이 되는 입력 스트림의 available 메소드를 호출합니다. available 메소드는 거기에 이륙 시각의 연기 된 바이트수를 더한 값을 돌려줍니다.

오버라이드(override):

클래스 FilterInputStream 내의 available

반환값:

블록 하지 않고 입력 스트림으로부터 읽어들일 수가 있는 바이트수

예외:

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

관련 항목:

FilterInputStream.in , InputStream.available()

skip

public long skip(long n)
          throws IOException 

이 입력 스트림으로부터 의 데이터를 n 바이트만 스킵 해 파기합니다. 다양한 이유로 skip 메소드는 지정되었던 것보다도 적은 바이트수 (제로의 경우도 있다) 밖에 스킵 하지 않는 것이 있습니다. n 가 부의 경우, 바이트는 스킵 되지 않습니다.

PushbackInputStream 의 skip 메소드는 우선, 이륙 시각의 연기 버퍼내에 바이트가 있으면 그것을 스킵 합니다. 다음에, 한층 더 바이트를 스킵 할 필요가 있는 경우는 기본이 되는 입력 스트림의 skip 메소드를 호출합니다. 스킵 된 실제의 바이트수가 돌려주어집니다.

오버라이드(override):

클래스 FilterInputStream 내의 skip

파라미터:

n - 스킵 하는 바이트수

반환값:

실제로 스킵 된 바이트수

예외:

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

도입된 버젼:

1.2

관련 항목:

FilterInputStream.in , InputStream.skip(long n)

markSupported

public boolean markSupported()

이 입력 스트림이,mark 메소드와 reset 메소드를 서포트하고 있을지 어떨지를 판정합니다. 이러한 메소드는 서포트되고 있지 않습니다.

오버라이드(override):

클래스 FilterInputStream 내의 markSupported

반환값:

이 클래스는 mark 메소드와 reset 메소드를 서포트하고 있지 않았기 때문에,false

관련 항목:

InputStream.mark(int) , InputStream.reset()

close

public void close()
           throws IOException 

이 입력 스트림을 닫아 그 스트림에 관련하는 모든 system resource를 해방합니다.

오버라이드(override):

클래스 FilterInputStream 내의 close

예외:

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

관련 항목:

FilterInputStream.in