Question

java.lang.Object
  └java.io.OutputStream
      └java.io.FilterOutputStream
          └java.io.DataOutputStream

所有已实现的接口：

Closeable, DataOutput, Flushable

---

public class DataOutputStream

extends FilterOutputStream

implements DataOutput

数据输出流允许应用程序以适当方式将基本 Java 数据类型写入输出流中。然后，应用程序可以使用数据输入流将数据读入。

从以下版本开始：

JDK1.0

另请参见：

DataInputStream

---

字段摘要
protected int	written 到目前为止写入数据输出流的字节数。

从类 java.io.FilterOutputStream 继承的字段
out

构造方法摘要
DataOutputStream(OutputStreamout) 创建一个新的数据输出流，将数据写入指定基础输出流。

方法摘要
void	flush() 清空此数据输出流。
int	size() 返回计数器 written 的当前值，即到目前为止写入此数据输出流的字节数。
void	write(byte[]b, intoff, intlen) 将指定字节数组中从偏移量 off 开始的 len 个字节写入基础输出流。
void	write(intb) 将指定字节（参数 b 的八个低位）写入基础输出流。
void	writeBoolean(booleanv) 将一个 boolean 值以 1-byte 值形式写入基础输出流。
void	writeByte(intv) 将一个 byte 值以 1-byte 值形式写出到基础输出流中。
void	writeBytes(Strings) 将字符串按字节顺序写出到基础输出流中。
void	writeChar(intv) 将一个 char 值以 2-byte 值形式写入基础输出流中，先写入高字节。
void	writeChars(Strings) 将字符串按字符顺序写入基础输出流。
void	writeDouble(doublev) 使用 Double 类中的 doubleToLongBits 方法将 double 参数转换为一个 long 值，然后将该 long 值以 8-byte 值形式写入基础输出流中，先写入高字节。
void	writeFloat(floatv) 使用 Float 类中的 floatToIntBits 方法将 float 参数转换为一个 int 值，然后将该 int 值以 4-byte 值形式写入基础输出流中，先写入高字节。
void	writeInt(intv) 将一个 int 值以 4-byte 值形式写入基础输出流中，先写入高字节。
void	writeLong(longv) 将一个 long 值以 8-byte 值形式写入基础输出流中，先写入高字节。
void	writeShort(intv) 将一个 short 值以 2-byte 值形式写入基础输出流中，先写入高字节。
void	writeUTF(Stringstr) 以与机器无关方式使用 UTF-8 修改版编码将一个字符串写入基础输出流。

从类 java.io.FilterOutputStream 继承的方法
close, write

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

从接口 java.io.DataOutput 继承的方法
write

字段详细信息

written

protected int written

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

构造方法详细信息

DataOutputStream

public DataOutputStream(OutputStreamout)

创建一个新的数据输出流，将数据写入指定基础输出流。计数器 written 被设置为零。

参数：

out - 基础输出流，将被保存供以后使用。

另请参见：

FilterOutputStream.out

方法详细信息

write

public void write(intb)
           throws IOException

将指定字节（参数 b 的八个低位）写入基础输出流。如果没有抛出异常，则计数器 written 增加 1 。

实现 OutputStream 的 write 方法。

指定者：

接口 DataOutput 中的 write

覆盖：

类 FilterOutputStream 中的 write

参数：

b - 要写入的 byte 。

抛出：

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

另请参见：

FilterOutputStream.out

---

write

public void write(byte[]b,
                  intoff,
                  intlen)
           throws IOException

将指定字节数组中从偏移量 off 开始的 len 个字节写入基础输出流。如果没有抛出异常，则计数器 written 增加 len 。

指定者：

接口 DataOutput 中的 write

覆盖：

类 FilterOutputStream 中的 write

参数：

b - 数据。

off - 数据中的起始偏移量。

len - 要写入的字节数。

抛出：

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

另请参见：

FilterOutputStream.out

---

flush

public void flush()
           throws IOException

清空此数据输出流。这迫使所有缓冲的输出字节被写出到流中。

DataOutputStream 的 flush 方法调用其基础输出流的 flush 方法。

指定者：

接口 Flushable 中的 flush

覆盖：

类 FilterOutputStream 中的 flush

抛出：

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

另请参见：

FilterOutputStream.out , OutputStream.flush()

---

writeBoolean

public final void writeBoolean(booleanv)
                        throws IOException

将一个 boolean 值以 1-byte 值形式写入基础输出流。值 true 以值 (byte)1 的形式被写出；值 false 以值 (byte)0 的形式被写出。如果没有抛出异常，则计数器 written 增加 1 。

指定者：

接口 DataOutput 中的 writeBoolean

参数：

v - 要写入的 boolean 值。

抛出：

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

另请参见：

FilterOutputStream.out

---

writeByte

public final void writeByte(intv)
                     throws IOException

将一个 byte 值以 1-byte 值形式写出到基础输出流中。如果没有抛出异常，则计数器 written 增加 1 。

指定者：

接口 DataOutput 中的 writeByte

参数：

v - 要写入的 byte 值。

抛出：

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

另请参见：

FilterOutputStream.out

---

writeShort

public final void writeShort(intv)
                      throws IOException

将一个 short 值以 2-byte 值形式写入基础输出流中，先写入高字节。如果没有抛出异常，则计数器 written 增加 2 。

指定者：

接口 DataOutput 中的 writeShort

参数：

v - 要写入的 short 值。

抛出：

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

另请参见：

FilterOutputStream.out

---

writeChar

public final void writeChar(intv)
                     throws IOException

将一个 char 值以 2-byte 值形式写入基础输出流中，先写入高字节。如果没有抛出异常，则计数器 written 增加 2 。

指定者：

接口 DataOutput 中的 writeChar

参数：

v - 要写入的 char 值。

抛出：

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

另请参见：

FilterOutputStream.out

---

writeInt

public final void writeInt(intv)
                    throws IOException

将一个 int 值以 4-byte 值形式写入基础输出流中，先写入高字节。如果没有抛出异常，则计数器 written 增加 4 。

指定者：

接口 DataOutput 中的 writeInt

参数：

v - 要写入的 int 值。

抛出：

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

另请参见：

FilterOutputStream.out

---

writeLong

public final void writeLong(longv)
                     throws IOException

将一个 long 值以 8-byte 值形式写入基础输出流中，先写入高字节。如果没有抛出异常，则计数器 written 增加 8 。

指定者：

接口 DataOutput 中的 writeLong

参数：

v - 要写入的 long 值。

抛出：

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

另请参见：

FilterOutputStream.out

---

writeFloat

public final void writeFloat(floatv)
                      throws IOException

使用 Float 类中的 floatToIntBits 方法将 float 参数转换为一个 int 值，然后将该 int 值以 4-byte 值形式写入基础输出流中，先写入高字节。如果没有抛出异常，则计数器 written 增加 4 。

指定者：

接口 DataOutput 中的 writeFloat

参数：

v - 要写入的 float 值。

抛出：

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

另请参见：

FilterOutputStream.out , Float.floatToIntBits(float)

---

writeDouble

public final void writeDouble(doublev)
                       throws IOException

使用 Double 类中的 doubleToLongBits 方法将 double 参数转换为一个 long 值，然后将该 long 值以 8-byte 值形式写入基础输出流中，先写入高字节。如果没有抛出异常，则计数器 written 增加 8 。

指定者：

接口 DataOutput 中的 writeDouble

参数：

v - 要写入的 double 值。

抛出：

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

另请参见：

FilterOutputStream.out , Double.doubleToLongBits(double)

---

writeBytes

public final void writeBytes(Strings)
                      throws IOException

将字符串按字节顺序写出到基础输出流中。按顺序写出字符串中每个字符，丢弃其八个高位。如果没有抛出异常，则计数器 written 增加 s 的长度。

指定者：

接口 DataOutput 中的 writeBytes

参数：

s - 要写入的字节字符串。

抛出：

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

另请参见：

FilterOutputStream.out

---

writeChars

public final void writeChars(Strings)
                      throws IOException

将字符串按字符顺序写入基础输出流。通过 writeChar 方法将每个字符写入数据输出流。如果没有抛出异常，则计数器 written 增加 s 长度的两倍。

指定者：

接口 DataOutput 中的 writeChars

参数：

s - 要写入的 String 值。

抛出：

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

另请参见：

writeChar(int) , FilterOutputStream.out

---

writeUTF

public final void writeUTF(Stringstr)
                    throws IOException

以与机器无关方式使用 UTF-8 修改版编码将一个字符串写入基础输出流。

首先，通过 writeShort 之类的方法将两个字节写入输出流，表示后跟的字节数。该值是实际写出的字节数，不是字符串的长度。根据此长度，使用字符的 UTF-8 修改版编码按顺序输出字符串的每个字符。如果没有抛出异常，则计数器 written 增加写入输出流的字节总数。该值至少是 2 加 str 的长度，最多是 2 加 str 的三倍长度。

指定者：

接口 DataOutput 中的 writeUTF

参数：

str - 要写入的字符串。

抛出：

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

---

size

public final int size()

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

返回：

written 字段的值。

另请参见：

written