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

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 错误。