THE PACKAGE JAVA.IO

java.io.DataOutput

22.2

22.2.2

public void write(byte[] b)

throws IOException, NullPointerException

The general contract for

write

 is that all the bytes in array

b

 are written, in order,

to the output stream.

If

b

 is

null

, a

NullPointerException

 is thrown.

If

b.length

 is zero, then no bytes are written. Otherwise, the byte

b[0]

 is

written first, then

b[1]

, and so on; the last byte written is

b[b.length 1]

.

22.2.3

public void write(byte[] b, int off, int len)

throws IOException, NullPointerException,

IndexOutOfBoundsException

The general contract for

write

 is that

len

 bytes from array

b

 are written, in order,

to the output stream.

If

b

 is

null

, a

NullPointerException

 is thrown.

If

off

 is negative, or

len

 is negative, or

off+len

 is greater than the length of

the array

b

, then an

IndexOutOfBoundsException

 is thrown.

If

len

 is zero, then no bytes are written. Otherwise, the byte

b[off]

 is written

first, then

b[off+1]

, and so on; the last byte written is

b[off+len 1]

.

22.2.4

public void writeBoolean(boolean v) throws IOException

The general contract for

writeBoolean

 is that one byte is written to the output

stream. If the argument

v

 is

true

, the value

(byte)1

 is written; if

v

 is

false

, the

value

(byte)0

 is written.

The byte written by this method may be read by the

readBoolean

 method of

interface

DataInput

 ( 22.1.4), which will then return a

boolean

 equal to

v

.

22.2.5

public void writeByte(int v) throws IOException

The general contract for

writeByte

 is that one byte is written to the output stream

to represent the value of the argument. The byte to be written is the eight low 

order bits of the argument

b

. The 24 high order bits of

b

 are ignored. (This means

that

writeByte

 does exactly the same thing as

write

 for an integer argument.)

The byte written by this method may be read by the

readByte

 method of

interface

DataInput

 ( 22.1.5), which will then return a

byte

 equal to

(byte)v

.

675