©
이 문서에서는 PHP 중국어 웹사이트 매뉴얼 풀어 주다
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
public interface DataOutput
DataOutput 接口用于将数据从任意 Java 基本类型转换为一系列字节，并将这些字节写入二进制流。同时还提供了一个将 String 转换成 UTF-8 修改版格式并写入所得到的系列字节的工具。
对于此接口中写入字节的所有方法，如果由于某种原因无法写入某个字节，则抛出 IOException。
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 s)
将表示长度信息的两个字节写入输出流，后跟字符串 s 中每个字符的 UTF-8 修改版表示形式。 |
| 方法详细信息 |
|---|
void write(int b)
throws IOException
b 的八个低位写入输出流。忽略 b 的 24 个高位。
b - 要写入的字节。
IOException - 如果发生 I/O 错误。
void write(byte[] b)
throws IOException
b 中的所有字节写入输出流。如果 b 为 null，则抛出 NullPointerException。如果 b.length 为零，则不写入字节。否则，首先写入字节 b[0]，然后写入字节 b[1]，依此类推；最后一个写入字节是 b[b.length-1]。
b - 数据。
IOException - 如果发生 I/O 错误。
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 错误。
void writeBoolean(boolean v)
throws IOException
boolean 值写入输出流。如果参数 v 为 true，则写入值 (byte)1；如果 v 为 false，则写入值 (byte)0。此方法写入的字节可由 DataInput 接口的 readBoolean 方法读取，然后该方法将返回一个等于 v 的 boolean 值。
v - 要写入的 boolean 值。
IOException - 如果发生 I/O 错误。
void writeByte(int v)
throws IOException
v 的八个低位写入输出流。忽略 v 的 24 个高位。（这意味着 writeByte 的作用与使用整数做参数的 write 完全相同。）此方法写入的字节可由 DataInput 接口的 readByte 方法读取，然后该方法将返回一个等于 (byte)v 的 byte 值。
v - 要写入的字节值。
IOException - 如果发生 I/O 错误。
void writeShort(int v)
throws IOException
(byte)(0xff & (v >> 8))
(byte)(0xff & v)
此方法写入的字节可由 DataInput 接口的 readShort 方法读取，然后该方法将返回一个等于 (short)v 的 short 值。
v - 要写入的 short 值。
IOException - 如果发生 I/O 错误。
void writeChar(int v)
throws IOException
char 值写入输出流，该值由两个字节组成。要写入的字节值（按顺序显示）是：
(byte)(0xff & (v >> 8))
(byte)(0xff & v)
此方法写入的字节可由 DataInput 接口的 readChar 方法读取，然后该方法将返回一个等于 (char)v 的 char 值。
v - 要写入的 char 值。
IOException - 如果发生 I/O 错误。
void writeInt(int v)
throws IOException
int 值写入输出流，该值由四个字节组成。要写入的字节值（按顺序显示）是：
(byte)(0xff & (v >> 24))
(byte)(0xff & (v >> 16))
(byte)(0xff & (v >> 8))
(byte)(0xff & v)
此方法写入的字节可由 DataInput 接口的 readInt 方法读取，然后该方法将返回一个等于 v 的 int 值。
v - 要写入的 int 值。
IOException - 如果发生 I/O 错误。
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 方法读取，然后该方法将返回一个等于 v 的 long 值。
v - 要写入的 long 值。
IOException - 如果发生 I/O 错误。
void writeFloat(float v)
throws IOException
float 值写入输出流，该值由四个字节组成。实现这一点的方式是：首先使用与 Float.floatToIntBits 方法完全相同的方式将此 float 值转换为一个 int 值，然后使用与 writeInt 方法完全相同的方式写入该 int 值。此方法写入的字节可由 DataInput 接口的 readFloat 方法读取，然后该方法将返回一个等于 v 的 float 值。
v - 要写入的 float 值。
IOException - 如果发生 I/O 错误。
void writeDouble(double v)
throws IOException
double 值写入输出流，该值由八个字节组成。实现这一点的方式是：首先使用与 Double.doubleToLongBits 方法相同的方式将此 double 值转换为一个 long 值，然后使用与 writeLong 方法完全相同的方式写入该 long 值。此方法写入的字节可由 DataInput 接口的 readDouble 方法读取，然后该方法将返回一个等于 v 的 double 值。
v - 要写入的 double 值。
IOException - 如果发生 I/O 错误。
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 错误。
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 错误。
void writeUTF(String s)
throws IOException
s 中每个字符的 UTF-8 修改版表示形式。如果 s 为 null，则抛出 NullPointerException。根据字符的值，将字符串 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 中所有字符的 1 字节、2 字节或 3 字节表示形式。
此方法写入的字节可由 DataInput 接口的 readUTF 方法读取，然后该方法将返回一个等于 s 的 String 值。
s - 要写入的字符串值。
IOException - 如果发生 I/O 错误。
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。