java.io
클래스 PushbackInputStream

java.lang.Object 
  java.io.InputStream 
      java.io.FilterInputStream 
          java.io.PushbackInputStream

모든 구현된 인터페이스:

Closeable

public class PushbackInputStream
extends FilterInputStream 

PushbackInputStream는 다른 입력 스트림에 기능을 추가합니다. 구체적으로는 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를 해방합니다.
void	mark (int readlimit) 이 입력 스트림의 현재 위치에 마크를 설정합니다.
boolean	markSupported () 이 입력 스트림이, mark 메서드와 reset 메서드를 지원하고 있을지 어떨지를 판정합니다.
int	read () 이 입력 스트림로부터, 데이터의 다음의 바이트를 읽어들입니다.
int	read (byte[] b, int off, int len) 이 입력 스트림로부터, len 바이트까지의 데이터를 바이트의 배열에 읽어들입니다.
void	reset () 이 스트림의 위치를, 입력 스트림로 마지막에 mark 메서드가 불려 갔을 때의 마크 위치에 재설정합니다.
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 로부터 상속된 메서드

read

클래스 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 - 바이트의 읽을 입력 스트림

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

예외:

IllegalArgumentException - 사이즈가 0 아래의 경우

도입된 버전 :

JDK1. 1

PushbackInputStream

public PushbackInputStream(InputStream  in)

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

파라미터:

in - 바이트의 읽을 입력 스트림

메서드의 상세

read

public int read()
         throws IOException 

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

이 메서드는 마지막에 이륙 시각의 연기 된 바이트가 있는 경우에는 그것을 리턴합니다. 그것이 없는 경우, 그 기본이 되는 입력 스트림의 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()

mark

public void mark(int readlimit)

이 입력 스트림의 현재 위치에 마크를 설정합니다.

PushbackInputStream mark 메서드는 아무것도 실시하지 않습니다.

오버라이드(override):

클래스 FilterInputStream 내의 mark

파라미터:

readlimit - 마크 위값이 무효가 되기 전에 읽기 가능한 바이트의 최대 리밋트

관련 항목:

InputStream.reset()

reset

public void reset()
           throws IOException 

이 스트림의 위치를, 입력 스트림로 마지막에 mark 메서드가 불려 갔을 때의 마크 위치에 재설정합니다.

PushbackInputStream 클래스의 reset 메서드는 IOException을 Throw 하는 이외 아무것도 실시하지 않습니다.

오버라이드(override):

클래스 FilterInputStream 내의 reset

예외:

IOException - 이 메서드가 불려 갔을 경우

관련 항목:

InputStream.mark(int), IOException

close

public void close()
           throws IOException 

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

정의:

인터페이스 Closeable 내의 close

오버라이드(override):

클래스 FilterInputStream 내의 close

예외:

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

관련 항목:

FilterInputStream.in