compact1, compact2, compact3

java.io

Class ByteArrayInputStream

java.lang.Object

java.io.InputStream

java.io.ByteArrayInputStream

All Implemented Interfaces:

Closeable ， AutoCloseable

public class ByteArrayInputStream
extends InputStream

A ByteArrayInputStream包含一个内部缓冲区，其中包含可以从流中读取的字节。 内部计数器跟踪read方法要提供的下一个字节。

关闭ByteArrayInputStream没有任何效果。 在关闭流之后，可以调用此类中的方法，而不生成IOException 。

从以下版本开始：

JDK1.0

另请参见：

StringBufferInputStream

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	buf 由数据流的创建者提供的字节数组。
protected int	count 索引一大于输入流缓冲区中的最后一个有效字符。
protected int	mark 流中当前标记的位置。
protected int	pos 从输入流缓冲区读取的下一个字符的索引。

构造方法摘要

构造方法

Constructor and Description
ByteArrayInputStream(byte[] buf) 创建一个 ByteArrayInputStream ，使其使用 buf作为其缓冲区数组。
ByteArrayInputStream(byte[] buf, int offset, int length) 创建 ByteArrayInputStream使用 buf作为其缓冲器阵列。

方法摘要

Modifier and Type	Method and Description
int	available() 返回可从此输入流读取（或跳过）的剩余字节数。
void	close() 关闭 ByteArrayInputStream没有任何效果。
void	mark(int readAheadLimit) 设置流中当前标记的位置。
boolean	markSupported() 测试 InputStream是否支持标记/复位。
int	read() 从该输入流读取下一个数据字节。
int	read(byte[] b, int off, int len) 将 len字节的数据读入此输入流中的字节数组。
void	reset() 将缓冲区重置为标记位置。
long	skip(long n) 从此输入流跳过 n个字节的输入。

Methods inherited from class java.io.InputStream

read

Methods inherited from class java.lang.Object

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

字段详细信息

buf

protected byte[] buf

由数据流的创建者提供的字节数组。 元素buf[0]至buf[count-1]是唯一可以从流中读取的字节; 元素buf[pos]是要读取的下一个字节。

pos

protected int pos

从输入流缓冲区读取的下一个字符的索引。 该值应始终为非负数，不得大于count的值。 要从输入流缓冲区读取的下一个字节将为buf[pos] 。

mark

protected int mark

流中当前标记的位置。 当构造时，ByteArrayInputStream对象在默认情况下标记为零。 它们可以通过mark()方法标记在缓冲区内的另一个位置。 目前的缓冲区位置由reset()方法设置。

如果没有设置标记，则标记的值是传递给构造函数的偏移量（如果没有提供偏移量，则为0）。

从以下版本开始：

JDK1.1

count

protected int count

索引一大于输入流缓冲区中的最后一个有效字符。 该值应始终为非负数，不得大于buf的长度。 它大于buf中可以从输入流缓冲区读取的最后一个字节的位置。

构造方法详细信息

ByteArrayInputStream

public ByteArrayInputStream(byte[] buf)

创建一个ByteArrayInputStream ，使其使用buf作为其缓冲区数组。 缓冲区数组不被复制。 的初始值pos是0和的初始值count是长度buf 。

参数

buf - 输入缓冲区。

ByteArrayInputStream

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

创建ByteArrayInputStream使用buf作为其缓冲器阵列。 的初始值pos是offset和的初始值count是的最小offset+length和buf.length 。 缓冲区数组不被复制。 缓冲区的标记设置为指定的偏移量。

参数

buf - 输入缓冲区。

offset - 要读取的第一个字节的缓冲区中的偏移量。

length - 从缓冲区读取的最大字节数。

方法详细信息

read

public int read()

从该输入流读取下一个数据字节。 值字节返回为int ，范围为0至255 。 如果没有字节可用，因为流已经到达，则返回值-1 。

这个read方法无法阻止。

Specified by:

read在 InputStream

结果

数据的下一个字节，如果已经达到流的末尾， -1 。

read

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

从此输入流读取最多len字节的数据到一个字节数组。 如果pos等于count ，则返回-1以指示文件结束。 否则，读取的字节数为k等于len和count-pos中的较小count-pos 。 如果k为正，则字节buf[pos]通过buf[pos+k-1]被复制到b[off]通过b[off+k-1]中所执行的方式System.arraycopy 。 值k被添加到pos并返回k 。

这个read方法不能阻止。

重写：

read在 InputStream

参数

b - 读取数据的缓冲区。

off - 目标数组中的起始偏移量 b

len - 读取的最大字节数。

结果

读取到缓冲区的总字节数，如果没有更多的数据，因为已经到达流的末尾， -1 。

异常

NullPointerException - 如果 b是 null 。

IndexOutOfBoundsException - 如果 off为负数，则 len为负数，或 len大于 b.length - off

另请参见：

InputStream.read()

skip

public long skip(long n)

从此输入流跳过n个字节的输入。 如果达到输入流的结尾，则可能会跳过更少的字节。 要跳过的字节的实际数字为k等于n和count-pos中的较小count-pos 。 值k被添加到pos ，返回k 。

重写：

skip在 InputStream

参数

n - 要跳过的字节数。

结果

实际跳过的字节数。

available

public int available()

返回可从此输入流读取（或跳过）的剩余字节数。

返回的值为count - pos ，这是从输入缓冲区读取的剩余字节数。

重写：

available在类别 InputStream

结果

可以从该输入流中读取（或跳过）而不阻塞的剩余字节数。

markSupported

public boolean markSupported()

测试InputStream是否支持标记/复位。 该markSupported的方法ByteArrayInputStream总是返回true 。

重写：

markSupported在 InputStream

结果

true如果这个流实例支持标记和重置方法; false否则。

从以下版本开始：

JDK1.1

另请参见：

InputStream.mark(int) ， InputStream.reset()

mark

public void mark(int readAheadLimit)

设置流中当前标记的位置。 当构造时，ByteArrayInputStream对象在默认情况下标记为零。 它们可以通过此方法标记在缓冲区内的另一个位置。

如果没有设置标记，则标记的值是传递给构造函数的偏移量（如果没有提供偏移量，则为0）。

注意：这个班的readAheadLimit没有意义。

重写：

mark在类别 InputStream

参数

readAheadLimit - 标记位置无效之前可以读取的最大字节数限制。

从以下版本开始：

JDK1.1

另请参见：

InputStream.reset()

reset

public void reset()

将缓冲区重置为标记位置。 标记位置为0，除非在构造函数中指定了另一个位置或者指定了一个偏移量。

重写：

reset在 InputStream

另请参见：

InputStream.mark(int) ， IOException

close

public void close()
           throws IOException

关闭ByteArrayInputStream没有任何效果。 在关闭流之后，可以调用此类中的方法，而不生成IOException 。

Specified by:

close在界面 Closeable

Specified by:

close在界面 AutoCloseable

重写：

close在 InputStream

异常

IOException - 如果发生I / O错误。