Java java.io 接口 DataOutput（JDK5）

所有类

概述  软件包   类  使用  树  已过时  索引  帮助
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

java.io
接口 DataOutput

所有已知子接口：

ImageOutputStream, ObjectOutput

所有已知实现类：

DataOutputStream, FileCacheImageOutputStream, FileImageOutputStream, ImageOutputStreamImpl, MemoryCacheImageOutputStream, ObjectOutputStream, RandomAccessFile

---

public interface DataOutput

DataOutput 接口用于将任意 Java 基本类型转换为一系列字节，并将这些字节写入二进制流。同时还提供了一个将 String 转换成 UTF-8 修改版格式并写入所得到的系列字节的工具。

对于此接口中写入字节的所有方法，如果由于某种原因无法写入某个字节，则抛出 IOException。

从以下版本开始：

JDK1.0

另请参见：

DataInput, DataOutputStream

---

方法摘要
void	write(byte[] b)           将数组 b 中的所有字节写入输出流。
void	write(byte[] b, int off, int len)           将数组 b 中的 len 个字节按顺序写入输出流。
void	write(int b)           将参数 b 的八个低位写入输出流。
void	writeBoolean(boolean v)           将一个 boolean 值写入输出流。
void	writeByte(int v)           将参数 v 的八个低位写入输出流。
void	writeBytes(String s)           将一个字符串写入输出流。
void	writeChar(int v)           将一个 char 值写入输出流，该值由两个字节组成。
void	writeChars(String s)           将字符串 s 中的所有字符按顺序写入输出流，每个字符用两个字节表示。
void	writeDouble(double v)           将一个 double 值写入输出流，该值由八个字节组成。
void	writeFloat(float v)           将一个 float 值写入输出流，该值由四个字节组成。
void	writeInt(int v)           将一个 int 值写入输出流，该值由四个字节组成。
void	writeLong(long v)           将一个 long 值写入输出流，该值由八个字节组成。
void	writeShort(int v)           将两个字节写入输出流，用它们表示参数值。
void	writeUTF(String str)           将表示长度信息的两个字节写入输出流，后跟字符串 s 中每个字符的 UTF-8 修改版表示形式。

 

方法详细信息

write

void write(int b)
           throws IOException

将参数 b 的八个低位写入输出流。忽略 b 的 24 个高位。

参数：

b - 要写入的字节。

抛出：

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

---

write

void write(byte[] b)
           throws IOException

将数组 b 中的所有字节写入输出流。如果 b 为 null，则抛出 NullPointerException。如果 b.length 为零，则不写入字节。否则，首先写入字节 b[0]，然后写入字节 b[1]，依此类推；最后一个写入字节是 b[b.length-1]。

参数：

b - 数据。

抛出：

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

---

write

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

将数组 b 中的 len 个字节按顺序写入输出流。如果 b 为 null，则抛出 NullPointerException。如果 off 为负，或 len 为负，抑或 off+len 大于数组 b 的长度，则抛出 IndexOutOfBoundsException。如果 len 为零，则不写入字节。否则，首先写入字节 b[off]，然后写入字节 b[off+1]，依此类推；最后一个写入字节是 b[off+len-1]。

参数：

b - 数据。

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

len - 要写入的字节数。

抛出：

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

---

writeBoolean

void writeBoolean(boolean v)
                  throws IOException

将一个 boolean 值写入输出流。如果参数 v 为 true，则写入值 (byte)1；如果 v 为 false，则写入值 (byte)0。此方法写入的字节可由 DataInput 接口的 readBoolean 方法读取，然后该方法将返回一个等于 v 的 boolean 值。

参数：

v - 要写入的 boolean 值。

抛出：

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

---

writeByte

void writeByte(int v)
               throws IOException

将参数 v 的八个低位写入输出流。忽略 v 的 24 个高位。（这意味着 writeByte 的作用与使用整数做参数的 write 完全相同。）此方法写入的字节可由 DataInput 接口的 readByte 方法读取，然后该方法将返回一个等于 (byte)v 的 byte 值。

参数：

v - 要写入的字节值。

抛出：

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

---

writeShort

void writeShort(int v)
                throws IOException

将两个字节写入输出流，用它们表示参数值。要写入的字节值（按顺序显示）是：

 (byte)(0xff & (v >> 8))
 (byte)(0xff & v)
  

此方法写入的字节可由 DataInput 接口的 readShort 方法读取，然后该方法将返回一个等于 (short)v 的 short 值。

参数：

v - 要写入的 short 值。

抛出：

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

---

writeChar

void writeChar(int v)
               throws IOException

将一个 char 值写入输出流，该值由两个字节组成。要写入的字节值（按顺序显示）是：

 (byte)(0xff & (v >> 8))
 (byte)(0xff & v)
 

此方法写入的字节可由 DataInput 接口的 readChar 方法读取，然后该方法将返回一个等于 (char)v 的 char 值。

参数：

v - 要写入的 char 值。

抛出：

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