Интерфейс DataOutput
- Все известные подинтерфейсы:
-
ImageOutputStream,ObjectOutput
- Все известные реализующие классы:
-
DataOutputStream,FileCacheImageOutputStream,FileImageOutputStream,ImageOutputStreamImpl,MemoryCacheImageOutputStream,ObjectOutputStream,RandomAccessFile
public interface DataOutput
DataOutput предоставляет возможность преобразования данных из любого из примитивных типов Java в последовательность байтов и записи этих байтов в бинарный поток. Также есть возможность преобразования String в формат изменённого UTF-8 и записи полученной последовательности байтов. Для всех методов в этом интерфейсе, которые записывают байты, обычно справедливо, что если байт не может быть записан по какой-либо причине, выбрасывается IOException.
- С:
- 1.0
- См. также:
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
write |
Записывает в выходной поток все байты в массиве b. |
void |
write |
Записывает len байтов из массива b, в порядке следования, в выходной поток. |
void |
write |
Записывает в выходной поток восемь младших битов аргумента b. |
void |
writeBoolean |
Записывает значение boolean в этот выходной поток. |
void |
writeByte |
Записывает в выходной поток восемь младших битов аргумента v. |
void |
writeBytes |
Записывает строку в выходной поток. |
void |
writeChar |
Записывает значение char, состоящее из двух байтов, в выходной поток. |
void |
writeChars |
Записывает каждый символ в строке s, в выходной поток, в порядке следования, по два байта на символ. |
void |
writeDouble |
Записывает значение double, состоящее из восьми байтов, в выходной поток. |
void |
writeFloat |
Записывает значение float, состоящее из четырёх байтов, в выходной поток. |
void |
writeInt |
Записывает значение int, состоящее из четырёх байтов, в выходной поток. |
void |
writeLong |
Записывает значение long, состоящее из восьми байтов, в выходной поток. |
void |
writeShort |
Записывает два байта в выходной поток для представления значения аргумента. |
void |
writeUTF |
Записывает два байта информации о длине в выходной поток, за которыми следует представление изменённого UTF-8 каждого символа в строке s. |
Подробное описание методов
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- если произошла ошибка ввода-вывода. -
IndexOutOfBoundsException- Еслиoffотрицательно,lenотрицательно, илиlenбольшеb.length - off
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)
Байты, записанные этим методом, могут быть прочитаны методом readShort интерфейса DataInput, который затем вернёт значение типа short, равное (short)v.
- Параметры:
-
v- значение типаshortдля записи. - Исключения:
-
IOException- если произошла ошибка ввода-вывода.
writeChar
void writeChar(int v) throws IOException
char, состоящее из двух байтов, в выходной поток. Значения байтов для записи, в указанном порядке, следующие:
(byte)(0xff & (v >> 8))
(byte)(0xff & v)
Байты, записанные этим методом, могут быть прочитаны методом readChar интерфейса DataInput, который затем вернёт значение типа char, равное (char)v.
- Параметры:
-
v- значение типаcharдля записи. - Исключения:
-
IOException- если произошла ошибка ввода-вывода.
writeInt
void writeInt(int v) throws IOException
int, состоящее из четырёх байтов, в выходной поток. Значения байтов для записи, в указанном порядке, следующие:
(byte)(0xff & (v >> 24))
(byte)(0xff & (v >> 16))
(byte)(0xff & (v >> 8))
(byte)(0xff & v)
Байты, записанные этим методом, могут быть прочитаны методом readInt интерфейса DataInput, который затем вернёт значение типа int, равное v.
- Параметры:
-
v- значение типаintдля записи. - Исключения:
-
IOException- если произошла ошибка ввода-вывода.
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)
Байты, записанные этим методом, могут быть прочитаны методом readLong интерфейса DataInput, который затем вернёт значение типа long, равное 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, взятом в порядке следования, один байт записывается в выходной поток. Если s равно null, выбрасывается NullPointerException. Если s.length равно нулю, то байты не записываются. В противном случае, сначала записывается символ s[0], затем s[1], и так далее; последний записанный символ — s[s.length-1]. Для каждого символа записывается один байт, младший байт, точно так же, как и в методе writeByte . 24 старших бита каждого символа в строке игнорируются.
- Параметры:
-
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
s. Если 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 — один, два или три байта.
Байты, записанные этим методом, могут быть прочитаны методом readUTF интерфейса DataInput, который затем вернёт String равное s.
- Параметры:
-
s- значение строки, подлежащее записи. - Исключение:
-
IOException- если произошла ошибка ввода-вывода.
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/DataOutput.html