Интерфейс DataOutput

Интерфейс DataOutput предоставляет возможность конвертировать данные из любого из примитивных типов Java в последовательность байтов и записывать эти байты в двоичный поток. Также есть возможность конвертировать String в формат модифицированного UTF-8 и записать полученную последовательность байтов.

Для всех методов в этом интерфейсе, которые записывают байты, обычно верно, что если байт не может быть записан по какой-либо причине, будет брошено исключение IOException.

Методы

write

void write(int b)
    throws IOException

Записывает в выходной поток восемь младших битов аргумента b. 24 старших бита аргумента b игнорируются.

Параметры:

b - байт, который должен быть записан.

Исключения:

IOException - если произошла ошибка ввода-вывода.

write

void write(byte[] b)
    throws IOException

Записывает в выходной поток все байты в массиве b. Если b равно null, выбрасывается исключение NullPointerException. Если b.length равно нулю, байты не записываются. В противном случае, сначала записывается байт b[0], затем b[1], и так далее; последний записанный байт — b[b.length-1].

Параметры:

b - данные.

Исключения:

IOException - если произошла ошибка ввода-вывода.

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 - если произошла ошибка ввода-вывода.

writeBoolean

void writeBoolean(boolean v)
           throws IOException

Записывает значение типа boolean в этот выходной поток. Если аргумент v равен true, записывается значение (byte)1; если v равно false, записывается значение (byte)0. Байт, записанный этим методом, может быть прочитан методом readBoolean интерфейса DataInput, который затем вернёт значение типа boolean, равное v.

Параметры:

v - булево значение для записи.

Исключения:

IOException - если произошла ошибка ввода-вывода.

writeByte

void writeByte(int v)
        throws IOException

Записывает в выходной поток восемь младших битов аргумента v. 24 старших бита аргумента v игнорируются. (Это означает, что writeByte делает ровно то же, что и write для целочисленного аргумента.) Байт, записанный этим методом, может быть прочитан методом readByte интерфейса DataInput, который затем вернёт значение типа byte, равное (byte)v.

Параметры:

v - значение байта для записи.

Исключения:

IOException - если произошла ошибка ввода-вывода.

writeShort

void writeShort(int v)
         throws IOException

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

Параметры:

v - значение типа short для записи.

Исключения:

IOException - если произошла ошибка ввода-вывода.

writeChar

void writeChar(int v)
        throws IOException

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

Параметры:

v - значение типа char для записи.

Исключения:

IOException - если произошла ошибка ввода-вывода.

writeInt

void writeInt(int v)
       throws IOException

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

Параметры:

v - значение типа int для записи.

Исключения:

IOException - если произошла ошибка ввода-вывода.

writeLong

void writeLong(long v)
        throws IOException

(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)

Параметры:

v - значение типа long для записи.

Исключения:

IOException - если произошла ошибка ввода-вывода.

writeFloat

void writeFloat(float v)
         throws IOException

Записывает значение типа float, которое состоит из четырёх байтов, в выходной поток. Для этого сначала это значение типа float преобразуется в значение типа int точно так же, как в методе Float.floatToIntBits, а затем значение типа int записывается точно так же, как в методе writeInt. Байты, записанные этим методом, могут быть прочитаны методом readFloat интерфейса DataInput, который затем вернёт значение типа float, равное v.

Параметры:

v - значение типа float для записи.

Исключения:

IOException - если произошла ошибка ввода-вывода.

writeDouble

void writeDouble(double v)
          throws IOException

Записывает значение типа double, которое состоит из восьми байтов, в выходной поток. Для этого сначала это значение типа double преобразуется в значение типа long точно так же, как в методе Double.doubleToLongBits, а затем значение типа long записывается точно так же, как в методе writeLong. Байты, записанные этим методом, могут быть прочитаны методом readDouble интерфейса DataInput, который затем вернёт значение типа double, равное v.

Параметры:

v - значение типа double для записи.

Исключения:

IOException - если произошла ошибка ввода-вывода.

writeBytes

void writeBytes(String s)
         throws IOException

Параметры:

s - строка байтов для записи.

Исключения:

IOException - если произошла ошибка ввода-вывода.

writeChars

void writeChars(String s)
         throws IOException

Записывает каждый символ в строке s, в выходной поток, в порядке следования, по два байта на символ. Если s равно null, выбрасывается исключение NullPointerException. Если s.length равно нулю, символы не записываются. В противном случае, сначала записывается символ s[0], затем s[1], и так далее; последний записанный символ — s[s.length-1]. Для каждого символа записываются два байта, старший байт первым, точно так же, как в методе writeChar.

Параметры:

s - строковое значение для записи.

Исключения:

IOException - если произошла ошибка ввода-вывода.

writeUTF

void writeUTF(String s)
       throws IOException

(byte)c

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

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

Параметры:

s - строковое значение для записи.

Исключения:

IOException - если произошла ошибка ввода-вывода.