compact1, compact2, compact3

java.io

Interface DataOutput

All Known Subinterfaces:

ImageOutputStream， ObjectOutput

所有已知实现类：

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

public interface DataOutput

的 DataOutput接口提供从任何的java的原始数据类型的一系列字节写这些字节的二进制流数据转换。还有一种转换成 modified UTF-8 String格式和写作产生的字节序列的设施。

在这个界面，写字节的方法，一般来说，如果一个字节不能以任何理由写的，一个IOException抛出。

从以下版本开始：

JDK1.0

另请参见：

DataInput， DataOutputStream

方法摘要

Modifier and Type	Method and Description
void	write(byte[] b) 写到输出流中的所有字节数组 b。
void	write(byte[] b, int off, int len) 写 len字节数组 b，为了到输出流。
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 s) 写两个字节长度的信息到输出流，其次是字符串中的每个字符的 modified UTF-8表示 s。

方法详细信息

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

写 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写。字节写的这个方法可以通过接口 DataInput readBoolean读的方法，这将返回一个 boolean等于 v。

参数

v -布尔写的。

异常

IOException如果I/O错误发生。

writeByte

void writeByte(int v)
        throws IOException

写到输出流八低的说法 v阶位，24阶位 v忽略。（这意味着 writeByte做同样的事情作为一个整型参数。 write）字节写的，这种方法可以通过接口 DataInput readByte读的方法，这将返回一个 byte等于 (byte)v。

参数

v -要写入的字节值。

异常

IOException如果I/O错误发生。

writeShort

void writeShort(int v)
         throws IOException

将两个字节写入输出流，以表示该参数的值。字节值被写入，显示的顺序，分别是：

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

字节写的这个方法可以通过接口DataInput readShort读的方法，这将返回一个short等于(short)v。

参数

v -要写入的 short价值。

异常

IOException如果I/O错误发生。

writeChar

void writeChar(int v)
        throws IOException

写一个 char价值，这是由两个字节，到输出流。字节值被写入，显示的顺序，分别是：

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

字节写的这个方法可以通过接口DataInput readChar读的方法，这将返回一个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)
 

字节写的这个方法可以通过接口DataInput readInt读的方法，这将返回一个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)
 

字节写的这个方法可以通过接口DataInput readLong读的方法，这将返回一个long等于v。

参数

v -要写入的 long价值。

异常

IOException如果I/O错误发生。

writeFloat

void writeFloat(float v)
         throws IOException

写一个 float值，它是由四个字节，到输出流。它好像一把这 float值的方法是 Float.floatToIntBits方式 int然后写 int价值完全 writeInt方式的方法。字节写的这个方法可以通过接口 DataInput readFloat读的方法，这将返回一个 float等于 v。

参数

v -要写入的 float价值。

异常

IOException如果I/O错误发生。

writeDouble

void writeDouble(double v)
          throws IOException

写一个 double值，它是由八个字节，到输出流。它好像一把这 double值在准确的 Double.doubleToLongBits方法方式 long然后写 long价值完全 writeLong方式的方法。字节写的这个方法可以通过接口 DataInput readDouble读的方法，这将返回一个 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方法的方式。字符串中的每个字符的高阶八位被忽略。

参数

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

写两个字节长度的信息到输出流，其次是字符串中的每个字符的 modified UTF-8表示 s。如果 s是 null，一 NullPointerException抛出。字符串中的每个字符 s转换为一组一个，两个，或三个字节，根据角色的价值。

如果一个角色c范围在\u0001通过\u007f，它是由一个字节表示：

（字节）

如果一个角色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写。

字节写的这个方法可以通过接口DataInput readUTF读的方法，这将返回一个String等于s。

参数

s -要写入的字符串值。

异常

IOException如果I/O错误发生。