Class ByteArrayInputStream

package java.io

java.lang.Object
  |
  +--java.io.InputStream
        |
        +--java.io.ByteArrayInputStream

설명

extends InputStream:

ByteArrayInputStream에는 스트림에서 읽을 수 있는 바이트가 포함되는 내부 버퍼가 있습니다. 내부 카운터는 read 메소드에서 제공할 다음 바이트를 추적합니다.

Since:

• JDK1.0, CLDC 1.0

필드 요약

• protected  byte[] buf — 스트림을 만든 사람이 제공한 바이트 배열.
• protected  int count — 입력 스트림 버퍼의 마지막 유효 문자에 1을 더한 색인.
• protected  int mark — 스트림에서 현재 표시된 위치.
• protected  int pos — 입력 스트림 버퍼에서 읽을 다음 문자의 색인.

생성자 요약

• ByteArrayInputStream (byte[] buf) buf 를 버퍼 배열로 사용하도록 ByteArrayInputStream 을 만듭니다.
• ByteArrayInputStream (byte[] buf, int offset, int length) buf 를 버퍼 배열로 사용하는 ByteArrayInputStream 을 만듭니다.

메서드 요약

• int available () — 차단되지 않고 이 입력 스트림에서 읽을 수 있는 바이트 수를 반환합니다.
• void close () — 이 입력 스트림을 닫고 스트림과 연결된 시스템 자원을 해제합니다.
• void mark (int readAheadLimit) — 스트림에서 현재 표시된 위치를 설정합니다.
• boolean markSupported () — ByteArrayInputStream이 표시/재설정을 지원하는지 테스트합니다.
• int read () — 이 입력 스트림에서 다음 바이트의 데이터를 읽습니다.
• int read (byte[] b, int off, int len) — 이 입력 스트림에서 최대 len 바이트의 데이터를 바이트 배열로 읽어 옵니다.
• void reset () — 버퍼를 표시된 위치로 재설정합니다.
• long skip (long n) — 이 입력 스트림에서 n 바이트의 입력을 건너뜁니다.

필드 상세

buf

protected byte[] buf

• 스트림을 만든 사람이 제공한 바이트 배열. buf[0]에서 buf[count-1]까지의 요소가 스트림에서 읽을 수 있는 유일한 바이트입니다. buf[pos] 요소는 읽을 다음 바이트입니다.

pos

protected int pos

• 입력 스트림 버퍼에서 읽을 다음 문자의 색인. 이 값은 항상 음수가 아니고 count 값보다 크지 않아야 합니다. 입력 스트림 버퍼에서 읽을 다음 바이트는 buf[pos]입니다.

mark

protected int mark

Since:

• JDK1.1

count

protected int count

• 입력 스트림 버퍼의 마지막 유효 문자에 1을 더한 색인. 이 값은 항상 음수가 아니고 buf 길이보다 크지 않아야 합니다. 입력 스트림 버퍼에서 읽을 수 있는 buf 내의 마지막 바이트 위치보다 1만큼 큽니다.

ByteArrayInputStream

public ByteArrayInputStream(byte[] buf)

• buf를 버퍼 배열로 사용하도록 ByteArrayInputStream을 만듭니다. 버퍼 배열은 복사되지 않습니다. pos의 초기 값은 0이고 count의 초기 값은 buf 길이입니다.

Parameters:

• buf - 입력 버퍼

ByteArrayInputStream

public ByteArrayInputStream(byte[] buf,
                            int offset,
                            int length)

• buf를 버퍼 배열로 사용하는 ByteArrayInputStream을 만듭니다. pos의 초기 값은 offset이고 count의 초기 값은 offset+length입니다. 버퍼 배열은 복사되지 않습니다.

결과로 만들어진 입력 스트림에서 단순히 바이트를 읽으면 buf[pos]에서 buf[pos+len-1]까지의 요소를 읽습니다. 하지만 reset 작업을 수행하면 buf[0]에서 buf[pos-1]까지의 바이트를 입력할 수 있게 됩니다.

Parameters:

• length - 버퍼에서 읽을 최대 바이트 수

read

public int read()

Specified by:

• read in class InputStream

Returns:

• 다음 바이트의 데이터 또는 스트림 끝에 도달한 경우 -1

read

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

Overrides:

• read in class InputStream

Parameters:

• len - 읽는 최대 바이트 수

Returns:

• 버퍼로 읽어들인 총 바이트 수 또는 스트림 끝에 도달하여 더 이상 데이터가 없는 경우 -1

See Also:

• InputStream.read()

skip

public long skip(long n)

Overrides:

• skip in class InputStream

Parameters:

• n - 건너뛸 바이트 수

Returns:

• 건너뛴 실제 바이트 수

available

public int available()

Overrides:

• available in class InputStream

Returns:

• 차단되지 않고 입력 스트림에서 읽을 수 있는 바이트 수

markSupported

public boolean markSupported()

Overrides:

• markSupported in class InputStream

Returns:

• 이 true 유형이 mark 메소드와 reset 메소드를 지원하면 true, 지원하지 않으면 false

Since:

• JDK1.1

See Also:

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

mark

public void mark(int readAheadLimit)

Overrides:

• mark in class InputStream

Parameters:

• readAheadLimit - 표시 위치가 무효화될 때까지 읽을 수 있는 최대 바이트 수 한계

Since:

• JDK1.1

See Also:

• InputStream.reset()

reset

public void reset()

Overrides:

• reset in class InputStream

See Also:

• InputStream.mark(int), IOException

close

public void close()
           throws IOException

Overrides:

• close in class InputStream

Throws:

• IOException - I/O 오류가 발생한 경우

생성자 상세

ByteArrayInputStream

public ByteArrayInputStream(byte[] buf)

• buf를 버퍼 배열로 사용하도록 ByteArrayInputStream을 만듭니다. 버퍼 배열은 복사되지 않습니다. pos의 초기 값은 0이고 count의 초기 값은 buf 길이입니다.

Parameters:

• buf - 입력 버퍼

ByteArrayInputStream

public ByteArrayInputStream(byte[] buf,
                            int offset,
                            int length)

• buf를 버퍼 배열로 사용하는 ByteArrayInputStream을 만듭니다. pos의 초기 값은 offset이고 count의 초기 값은 offset+length입니다. 버퍼 배열은 복사되지 않습니다.

결과로 만들어진 입력 스트림에서 단순히 바이트를 읽으면 buf[pos]에서 buf[pos+len-1]까지의 요소를 읽습니다. 하지만 reset 작업을 수행하면 buf[0]에서 buf[pos-1]까지의 바이트를 입력할 수 있게 됩니다.

Parameters:

• length - 버퍼에서 읽을 최대 바이트 수

read

public int read()

Specified by:

• read in class InputStream

Returns:

• 다음 바이트의 데이터 또는 스트림 끝에 도달한 경우 -1

read

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

Overrides:

• read in class InputStream

Parameters:

• len - 읽는 최대 바이트 수

Returns:

• 버퍼로 읽어들인 총 바이트 수 또는 스트림 끝에 도달하여 더 이상 데이터가 없는 경우 -1

See Also:

• InputStream.read()

skip

public long skip(long n)

Overrides:

• skip in class InputStream

Parameters:

• n - 건너뛸 바이트 수

Returns:

• 건너뛴 실제 바이트 수

available

public int available()

Overrides:

• available in class InputStream

Returns:

• 차단되지 않고 입력 스트림에서 읽을 수 있는 바이트 수

markSupported

public boolean markSupported()

Overrides:

• markSupported in class InputStream

Returns:

• 이 true 유형이 mark 메소드와 reset 메소드를 지원하면 true, 지원하지 않으면 false

Since:

• JDK1.1

See Also:

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

mark

public void mark(int readAheadLimit)

Overrides:

• mark in class InputStream

Parameters:

• readAheadLimit - 표시 위치가 무효화될 때까지 읽을 수 있는 최대 바이트 수 한계

Since:

• JDK1.1

See Also:

• InputStream.reset()

reset

public void reset()

Overrides:

• reset in class InputStream

See Also:

• InputStream.mark(int), IOException

close

public void close()
           throws IOException

Overrides:

• close in class InputStream

Throws:

• IOException - I/O 오류가 발생한 경우

메서드 상세

read

public int read()

Specified by:

• read in class InputStream

Returns:

• 다음 바이트의 데이터 또는 스트림 끝에 도달한 경우 -1

read

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

Overrides:

• read in class InputStream

Parameters:

• len - 읽는 최대 바이트 수

Returns:

• 버퍼로 읽어들인 총 바이트 수 또는 스트림 끝에 도달하여 더 이상 데이터가 없는 경우 -1

See Also:

• InputStream.read()

skip

public long skip(long n)

Overrides:

• skip in class InputStream

Parameters:

• n - 건너뛸 바이트 수

Returns:

• 건너뛴 실제 바이트 수

available

public int available()

Overrides:

• available in class InputStream

Returns:

• 차단되지 않고 입력 스트림에서 읽을 수 있는 바이트 수

markSupported

public boolean markSupported()

Overrides:

• markSupported in class InputStream

Returns:

• 이 true 유형이 mark 메소드와 reset 메소드를 지원하면 true, 지원하지 않으면 false

Since:

• JDK1.1

See Also:

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

mark

public void mark(int readAheadLimit)

Overrides:

• mark in class InputStream

Parameters:

• readAheadLimit - 표시 위치가 무효화될 때까지 읽을 수 있는 최대 바이트 수 한계

Since:

• JDK1.1

See Also:

• InputStream.reset()

reset

public void reset()

Overrides:

• reset in class InputStream

See Also:

• InputStream.mark(int), IOException

close

public void close()
           throws IOException

Overrides:

• close in class InputStream

Throws:

• IOException - I/O 오류가 발생한 경우