|
JavaTM 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 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。