compact1, compact2, compact3

java.io

Interface DataOutput

All Known Subinterfaces:

ImageOutputStream ， ObjectOutput

所有已知实现类：

DataOutputStream ， FileCacheImageOutputStream ， FileImageOutputStream ， ImageOutputStreamImpl ， MemoryCacheImageOutputStream ， ObjectOutputStream ， RandomAccessFile

public interface DataOutput

DataOutput接口提供将数据从任何Java基本类型转换为一系列字节，并将这些字节写入二进制流。 还有一种将String转换为modified UTF-8格式并编写结果字节系列的功能。

对于写入字节的这个接口中的所有方法，一般来说，如果一个字节不能由于任何原因写入，则抛出一个IOException 。

从以下版本开始：

JDK1.0

另请参见：

DataInput ， DataOutputStream

方法摘要

Modifier and Type	Method and Description
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值（由8个字节组成）写入输出流。
void	writeFloat(float v) 将 float值写入输出流，该值由四个字节组成。
void	writeInt(int v) 将 int值（由四个字节组成）写入输出流。
void	writeLong(long v) 将 long值（由八个字节组成）写入输出流。
void	writeShort(int v) 将两个字节写入输出流以表示参数的值。
void	writeUTF(String s) 将两个字节的长度信息写入输出流，其后是 字符串 s中每个字符的 s 。

方法详细信息

write

void write(int b)
    throws IOException

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

参数

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

将len字节从阵列b写入，输出流。 如果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 。 由该方法写入的字节可以由readBoolean的readBoolean DataInput ，然后返回boolean等于v 。

参数

v - 要写入的布尔值。

异常

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

writeByte

void writeByte(int v)
        throws IOException

向输出流写入参数v的八个低位位。 v的24位v被忽略。 （这意味着writeByte不完全一样的东西作为write为整数参数。）此方法写入的字节可以由读取readByte接口的方法DataInput ，然后将返回一个byte等于(byte)v 。

参数

v - 要写入的字节值。

异常

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

writeShort

void writeShort(int v)
         throws IOException

将两个字节写入输出流以表示参数的值。 要写入的字节值按照显示的顺序是：

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

由该方法写入的字节可以由readShort的readShort DataInput ，然后返回short等于(short)v 。

参数

v - short值。

异常

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

writeChar

void writeChar(int v)
        throws IOException

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

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

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

参数

v - char值。

异常

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

writeInt

void writeInt(int v)
       throws IOException

将int值写入输出流，该值由四个字节组成。 要写入的字节值按照显示的顺序是：

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

用这种方法写入的字节可以由读取readInt接口的方法DataInput ，则这将返回一个int等于v 。

参数

v - 要写入的 int值。

异常

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

writeLong

void writeLong(long v)
        throws IOException

将long值（由八个字节组成）写入输出流。 要写入的字节值按照显示的顺序是：

   (byte)(0xff & (v >> 56)) (byte)(0xff & (v >> 48)) (byte)(0xff & (v >> 40)) (byte)(0xff & (v >> 32)) (byte)(0xff & (v >> 24)) (byte)(0xff & (v >> 16)) (byte)(0xff & (v >> 8)) (byte)(0xff & v)  

用这种方法写入的字节可以由读取readLong接口的方法DataInput ，然后将返回一个long等于v 。

参数

v - long值。

异常

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

writeFloat

void writeFloat(float v)
         throws IOException

将float值写入输出流，该值由四个字节组成。 它这样做是因为，如果它首先将这个float值到int在完全相同的方式Float.floatToIntBits方法，然后再写入int在完全相同的方式值writeInt方法。 用这种方法写入的字节可以由读取readFloat接口的方法DataInput ，然后将返回一个float等于v 。

参数

v - float值。

异常

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

writeDouble

void writeDouble(double v)
          throws IOException

将double值（由8个字节组成）写入输出流。 它这样做是因为，如果它首先将这个double值到long在完全相同的方式Double.doubleToLongBits方法，然后再写入long在完全相同的方式值writeLong方法。 用这种方法写入的字节可以由读取readDouble接口的方法DataInput ，然后将返回一个double等于v 。

参数

v - 要写入的 double值。

异常

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

writeBytes

void writeBytes(String s)
         throws IOException

将一个字符串写入输出流。 对于字符串中的每个字符s ，为了拍摄，一个字节写入到输出流。 如果s是null ，则抛出一个NullPointerException 。

如果s.length为零，则不会写入任何字节。 否则，首先写入字符s[0] ，然后写入s[1] ，等等; 写最后一个字符是s[s.length-1] 。 对于每个字符，写入一个字节，低字节，按照writeByte方法的方式。 字符串中每个字符的高8位被忽略。

参数

s - 要写入的字节串。

异常

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

writeChars

void writeChars(String s)
         throws IOException

写入每一个字符在字符串中s ，到输出流中，为了，每个字符使用两个字节。 如果s是null ，则抛出一个NullPointerException 。 如果s.length为零，则不会写任何字符。 否则，首先写入字符s[0] ，然后写入s[1] ，等等; 写最后一个字符是s[s.length-1] 。 对于每个字符，两个字节实际上是以writeChar方式的方式写入高位字节。

参数

s - 要写入的字符串值。

异常

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

writeUTF

void writeUTF(String s)
       throws IOException

将两个字节的长度信息写入输出流，其后是字符串 s中每个字符的s 。 如果s是null ，则抛出一个NullPointerException 。 字符串s中的每个字符根据字符的值s为一个，两个或三个字节的组。

如果一个字符c在\u0001到\u007f ，它由一个字节表示：

  (byte)c 

如果一个字符c是\u0000或者在\u0080到\u07ff的范围内，那么它由两个字节表示，按照显示的顺序写：

   (byte)(0xc0 | (0x1f & (c >> 6))) (byte)(0x80 | (0x3f & c))  

如果字符c在\u0800到uffff ，那么它将由三个字节表示，按照显示的顺序写入：

   (byte)(0xe0 | (0x0f & (c >> 12))) (byte)(0x80 | (0x3f & (c >> 6))) (byte)(0x80 | (0x3f & c))  

首先，以表示的所有字符所需的字节的总数s被计算。 如果这个数字大于65535 ，则抛出一个UTFDataFormatException 。 否则，这个长度以writeShort方式的方式写入输出流; 之后，写入字符串s中的每个字符的一个，两个或三个字节的表示。

用这种方法写入的字节可以由读取readUTF接口的方法DataInput ，然后将返回一个String等于s 。

参数

s - 要写入的字符串值。

异常

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