Java java.io 类 ByteArrayOutputStream（JDK5）

150 阅读 0 评论 0 点赞

所有类

概述

软件包

类

使用

树

已过时

索引

帮助

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.io
类 ByteArrayOutputStream

java.lang.Object
  java.io.OutputStream
      java.io.ByteArrayOutputStream

所有已实现的接口：: Closeable, Flushable

public class ByteArrayOutputStream
extends OutputStream
extends OutputStream

此类实现了一个输出流，其中的数据被写入一个字节数组。缓冲区会随着数据的不断写入而自动增长。可使用 toByteArray() 和 toString() 检索数据。

关闭 ByteArrayOutputStream 无效。在关闭此流后且没有生成 IOException 时，可以调用此类中的该方法。

从以下版本开始：: JDK1.0

字段摘要
`protected byte[]`	`buf` 存储数据的缓冲区。
`protected int`	`count` 缓冲区中的有效字节数。

构造方法摘要
`ByteArrayOutputStream()` 创建一个新的字节数组输出流。
`ByteArrayOutputStream(int size)` 创建一个新的字节数组输出流，它具有指定大小的缓冲区容量（以字节为单位）。

方法摘要
`void`	`close()` 关闭 `ByteArrayOutputStream` 无效。
`void`	`reset()` 将此字节数组输出流的 `count` 字段重置为零，从而丢弃输出流中目前已累积的所有输出。
`int`	`size()` 返回缓冲区的当前大小。
`byte[]`	`toByteArray()` 创建一个新分配的字节数组。
`String`	`toString()` 将缓冲区的内容转换为字符串，根据平台的默认字符编码将字节转换成字符。
`String`	`toString(int hibyte)` 已过时。此方法无法将字节正确转换为字符。从 JDK 1.1 开始，完成该转换的首选方法是通过 `toString(String enc)` 方法（使用一个编码名称参数），或 `toString()` 方法（使用平台的默认字符编码）。
`String`	`toString(String enc)` 将缓冲区的内容转换为字符串，根据指定的字符编码将字节转换成字符。
`void`	`write(byte[] b, int off, int len)` 将指定字节数组中从偏移量 `off` 开始的 `len` 个字节写入此字节数组输出流。
`void`	`write(int b)` 将指定的字节写入此字节数组输出流。
`void`	`writeTo(OutputStream out)` 将此字节数组输出流的全部内容写入到指定的输出流参数中，这与使用 `out.write(buf, 0, count)` 调用该输出流的 write 方法效果一样。

从类 java.io.OutputStream 继承的方法
`flush, write`

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

字段详细信息

buf

protected byte[] buf

存储数据的缓冲区。

count

protected int count

缓冲区中的有效字节数。

构造方法详细信息

ByteArrayOutputStream

public ByteArrayOutputStream()

创建一个新的字节数组输出流。缓冲区的容量最初是 32 字节，如有必要可增加其大小。

ByteArrayOutputStream

public ByteArrayOutputStream(int size)

创建一个新的字节数组输出流，它具有指定大小的缓冲区容量（以字节为单位）。

参数：: size - 初始大小。
抛出：: IllegalArgumentException - 如果 size 为负。

方法详细信息

write

public void write(int b)

将指定的字节写入此字节数组输出流。

指定者：: 类 OutputStream 中的 write

参数：: b - 要写入的字节。

write

public void write(byte[] b,
                  int off,
                  int len)

将指定字节数组中从偏移量 off 开始的 len 个字节写入此字节数组输出流。

覆盖：: 类 OutputStream 中的 write

参数：: b - 数据。; off - 数据的初始偏移量。; len - 要写入的字节数。

writeTo

public void writeTo(OutputStream out)
             throws IOException

将此字节数组输出流的全部内容写入到指定的输出流参数中，这与使用 out.write(buf, 0, count) 调用该输出流的 write 方法效果一样。

参数：: out - 要写入数据的输出流。
抛出：: IOException - 如果发生 I/O 错误。

reset

public void reset()

将此字节数组输出流的 count 字段重置为零，从而丢弃输出流中目前已累积的所有输出。通过重新使用已分配的缓冲区空间，可以再次使用该输出流。

另请参见：: ByteArrayInputStream.count

toByteArray

public byte[] toByteArray()

创建一个新分配的字节数组。其大小是此输出流的当前大小，并且缓冲区的有效内容已复制到该数组中。

返回：: 以字节数组的形式返回此输出流的当前内容。
另请参见：: size()