鸿蒙OS开发文档 鸿蒙OS DataOutputStream

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 2

DataOutputStream

java.lang.Object
|---java.io.OutputStream
|---|---java.io.FilterOutputStream
|---|---|---java.io.DataOutputStream

public class DataOutputStream
extends FilterOutputStream
implements DataOutput

数据输出流允许应用程序以可移植的方式将原始 Java 数据类型写入输出流。 然后,应用程序可以使用数据输入流来读回数据。

Since:

JDK1.0

字段摘要

修饰符和类型字段描述
protected intwritten到目前为止写入数据输出流的字节数。
从类 java.io.FilterOutputStream 继承的字段
out

构造函数摘要

构造函数描述
DataOutputStream(OutputStream out)创建新的数据输出流以将数据写入指定的基础输出流。

方法总结

修饰符和类型方法描述
voidflush()刷新此数据输出流。
intsize()返回写入的计数器的当前值,即到目前为止写入此数据输出流的字节数。
voidwrite(byte[] b, int off, int len)将指定字节数组中的 len 个字节从 offset off 处开始写入底层输出流。
voidwrite(int b)将指定字节(参数 b 的低八位)写入底层输出流。
voidwriteBoolean(boolean v)将布尔值作为 1 字节值写入基础输出流。
voidwriteByte(int v)将一个字节作为 1 字节值写入底层输出流。
voidwriteBytes(String s)将字符串作为字节序列写入底层输出流。
voidwriteChar(int v)将 char 作为 2 字节值写入底层输出流,先是高字节。
voidwriteChars(String s)将字符串作为字符序列写入基础输出流。
voidwriteDouble(double v)使用 Double 类中的 doubleToLongBits 方法将 double 参数转换为 long,然后将该 long 值作为 8 字节数量写入底层输出流,先是高字节。
voidwriteFloat(float v)使用 Float 类中的 floatToIntBits 方法将 float 参数转换为 int,然后将该 int 值作为 4 字节数量写入底层输出流,先是高字节。
voidwriteInt(int v)将一个 int 作为四个字节写入底层输出流,先是高字节。
voidwriteLong(long v)将 long 作为 8 个字节写入底层输出流,先是高字节。
voidwriteShort(int v)以两个字节的形式将一个短路写入底层输出流,先是高字节。
voidwriteUTF(String str)使用修改后的 UTF-8 编码以与机器无关的方式将字符串写入底层输出流。
从接口 java.io.DataOutput 继承的方法
write
从类 java.io.FilterOutputStream 继承的方法
close, write
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

written

protected int written

到目前为止写入数据输出流的字节数。 如果此计数器溢出,它将被包装到 Integer.MAX_VALUE。

构造函数详细信息

DataOutputStream

public DataOutputStream(OutputStream out)

创建新的数据输出流以将数据写入指定的基础输出流。 写入的计数器设置为零。

参数:

参数名称参数描述
out底层输出流,保存以备后用。

方法详情

write

public void write(int b) throws IOException

将指定字节(参数 b 的低八位)写入底层输出流。 如果没有抛出异常,则写入的计数器加 1。

实现OutputStream的write方法。

指定者:

写入接口DataOutput

覆盖:

写在类 FilterOutputStream

参数:

参数名称参数描述
b要写入的字节。

Throws:

Throw名称Throw描述
IOException如果发生 I/O 错误。

write

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

将指定字节数组中的 len 个字节从 offset off 处开始写入底层输出流。 如果没有抛出异常,则写入的计数器增加 len。

指定者:

写入接口DataOutput

覆盖:

写在类 FilterOutputStream

参数:

参数名称参数描述
b数据。
off数据中的起始偏移量。
len要写入的字节数。

Throws:

Throw名称Throw描述
IOException如果发生 I/O 错误。

flush

public void flush() throws IOException

刷新此数据输出流。 这会强制将任何缓冲的输出字节写出到流中。

DataOutputStream 的 flush 方法调用其底层输出流的 flush 方法。

指定者:

在接口 Flushable 中刷新

覆盖:

类 FilterOutputStream 中的刷新

Throws:

Throw名称Throw描述
IOException如果发生 I/O 错误。

writeBoolean

public final void writeBoolean(boolean v) throws IOException

将布尔值作为 1 字节值写入基础输出流。 值 true 被写为值(字节)1; 值 false 被写为值(字节)0。 如果没有抛出异常,则写入的计数器加 1。

指定者:

接口 DataOutput 中的 writeBoolean

参数:

参数名称参数描述
v要写入的布尔值。

Throws:

Throw名称Throw描述
IOException如果发生 I/O 错误。

writeByte

public final void writeByte(int v) throws IOException

将一个字节作为 1 字节值写入底层输出流。 如果没有抛出异常,则写入的计数器加 1。

指定者:

接口 DataOutput 中的 writeByte

参数:

参数名称参数描述
v要写入的字节值。

Throws:

Throw名称Throw描述
IOException如果发生 I/O 错误。

writeShort

public final void writeShort(int v) throws IOException

以两个字节的形式将一个短路写入底层输出流,先是高字节。 如果没有抛出异常,则写入的计数器加 2。

指定者:

接口 DataOutput 中的 writeShort

参数:

参数名称参数描述
v一个要写的short。

Throws:

Throw名称Throw描述
IOException如果发生 I/O 错误。

writeChar

public final void writeChar(int v) throws IOException

将 char 作为 2 字节值写入底层输出流,先是高字节。 如果没有抛出异常,则写入的计数器加 2。

指定者:

接口 DataOutput 中的 writeChar

参数:

参数名称参数描述
v要写入的 char 值。

Throws:

Throw名称Throw描述
IOException如果发生 I/O 错误。

writeInt

public final void writeInt(int v) throws IOException

将一个 int 作为四个字节写入底层输出流,先是高字节。 如果没有抛出异常,则写入的计数器增加 4。

指定者:

接口 DataOutput 中的 writeInt

参数:

参数名称参数描述
v要写入的 int。

Throws:

Throw名称Throw描述
IOException如果发生 I/O 错误。

writeLong

public final void writeLong(long v) throws IOException

将 long 作为 8 个字节写入底层输出流,先是高字节。 在不抛出异常的情况下,写入的计数器增加 8。

指定者:

接口 DataOutput 中的 writeLong

参数:

参数名称参数描述
v要写一个long。

Throws:

Throw名称Throw描述
IOException如果发生 I/O 错误。

writeFloat

public final void writeFloat(float v) throws IOException

使用 Float 类中的 floatToIntBits 方法将 float 参数转换为 int,然后将该 int 值作为 4 字节数量写入底层输出流,先是高字节。 如果没有抛出异常,则写入的计数器增加 4。

指定者:

接口 DataOutput 中的 writeFloat

参数:

参数名称参数描述
v要写入的浮点值。

Throws:

Throw名称Throw描述
IOException如果发生 I/O 错误。

writeDouble

public final void writeDouble(double v) throws IOException

使用 Double 类中的 doubleToLongBits 方法将 double 参数转换为 long,然后将该 long 值作为 8 字节数量写入底层输出流,先是高字节。 如果没有抛出异常,则写入的计数器加 8。

指定者:

接口 DataOutput 中的 writeDouble

参数:

参数名称参数描述
v要写入的 double 值。

Throws:

Throw名称Throw描述
IOException如果发生 I/O 错误。

writeBytes

public final void writeBytes(String s) throws IOException

将字符串作为字节序列写入底层输出流。 字符串中的每个字符通过丢弃其高八位按顺序写出。 如果没有抛出异常,则写入的计数器增加 s 的长度。

指定者:

接口 DataOutput 中的 writeBytes

参数:

参数名称参数描述
s要写入的字节串。

Throws:

Throw名称Throw描述
IOException如果发生 I/O 错误。

writeChars

public final void writeChars(String s) throws IOException

将字符串作为字符序列写入基础输出流。 每个字符都被写入数据输出流,就像通过 writeChar 方法一样。 如果没有抛出异常,则写入的计数器增加 s 长度的两倍。

指定者:

接口 DataOutput 中的 writeChars

参数:

参数名称参数描述
s要写入的字符串值。

Throws:

Throw名称Throw描述
IOException如果发生 I/O 错误。

writeUTF

public final void writeUTF(String str) throws IOException

使用修改后的 UTF-8 编码以与机器无关的方式将字符串写入底层输出流。

首先,两个字节被写入输出流,就好像通过 writeShort 方法给出了后面的字节数。 这个值是实际写出的字节数,而不是字符串的长度。 在长度之后,使用修改后的 UTF-8 字符编码按顺序输出字符串的每个字符。 如果没有抛出异常,则写入的计数器将增加写入输出流的字节总数。 这将至少是 str 长度的两倍,最多是 str 长度的两倍。

指定者:

接口 DataOutput 中的 writeUTF

参数:

参数名称参数描述
str要写入的字符串。

Throws:

Throw名称Throw描述
IOException如果发生 I/O 错误。

size

public final int size()

返回写入的计数器的当前值,即到目前为止写入此数据输出流的字节数。 如果计数器溢出,它将被包装到 Integer.MAX_VALUE。

返回:

写入字段的值。