Spec-Zone.ru › OpenJDK 21

Класс DataOutputStream

java.lang.Object
java.io.OutputStream
java.io.FilterOutputStream
java.io.DataOutputStream
Все реализованные интерфейсы:
Closeable, DataOutput, Flushable, AutoCloseable 
public class DataOutputStream extends FilterOutputStream implements DataOutput
Поток вывода данных позволяет приложению записывать примитивные типы данных Java в поток вывода портативным способом. Затем приложение может использовать поток ввода данных для повторного считывания данных.

Класс DataOutputStream не является потокобезопасным. Если DataOutputStream должен использоваться более чем одной нитью, доступ к потоку вывода данных должен контролироваться соответствующей синхронизацией.

С момента:
1.0
См. также:
  • DataInputStream

Краткое описание полей

Модификатор и тип Поле Описание
protected int written
Количество байтов, записанных в поток вывода данных до сих пор.

Поля, объявленные в классе java.io.FilterOutputStream

out

Краткое описание конструкторов

Конструктор Описание
DataOutputStream(OutputStream out)
Создает новый поток вывода данных для записи данных в указанный базовый поток вывода.

Краткое описание методов

Модификатор и тип Метод Описание
void flush()
Сбрасывает этот поток вывода данных.
final int size()
Возвращает текущее значение счетчика written, количество байтов, записанных в этот поток вывода данных до сих пор.
void write(byte[] b, int off, int len)
Записывает len байтов из указанного массива байтов, начиная с смещения off в базовый поток вывода.
void write(int b)
Записывает указанный байт (нижние восемь бит аргумента b) в базовый поток вывода.
final void writeBoolean(boolean v)
Записывает boolean в базовый поток вывода как значение 1 байта.
final void writeByte(int v)
Записывает byte в базовый поток вывода как значение 1 байта.
final void writeBytes(String s)
Записывает строку в базовый поток вывода как последовательность байтов.
final void writeChar(int v)
Записывает char в базовый поток вывода как значение 2 байта, сначала старший байт.
final void writeChars(String s)
Записывает строку в базовый поток вывода как последовательность символов.
final void writeDouble(double v)
Преобразует аргумент типа double в long с помощью метода doubleToLongBits в классе Double, а затем записывает это значение long в базовый поток вывода как 8-байтовое значение, начиная со старшего байта.
final void writeFloat(float v)
Преобразует аргумент типа float в int с помощью метода floatToIntBits в классе Float, а затем записывает это значение int в базовый поток вывода как 4-байтовое значение, начиная со старшего байта.
final void writeInt(int v)
Записывает int в базовый поток вывода в виде четырёх байтов, начиная со старшего байта.
final void writeLong(long v)
Записывает long в базовый поток вывода как восемь байтов, начиная со старшего байта.
final void writeShort(int v)
Записывает short в базовый поток вывода как два байта, начиная со старшего байта.
final void writeUTF(String str)
Записывает строку в базовый поток вывода, используя кодировку изменённый UTF-8 независимо от машины.

Методы, объявленные в классе java.io.FilterOutputStream

close, write

Методы, объявленные в классе java.io.OutputStream

nullOutputStream

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, объявленные в интерфейсе java.io.DataOutput

write

Подробное описание полей

written

protected int written
Количество байт, записанных в поток данных до сих пор. Если этот счётчик переполнится, он будет обернут до Integer.MAX_VALUE.

Подробное описание конструкторов

DataOutputStream

public DataOutputStream(OutputStream out)
Создаёт новый поток вывода данных для записи данных в указанный поток вывода. Счётчик written устанавливается в ноль.
Параметры:
out - поток вывода, который будет сохранён для последующего использования.
См. также:
  • FilterOutputStream.out

Подробное описание методов

write

public void write(int b) throws IOException
Записывает указанный байт (нижние восемь бит аргумента b) в базовый поток вывода. Если исключение не было выброшено, счётчик written увеличивается на 1.

Реализует метод write интерфейса OutputStream.

Определено в:
write в интерфейсе DataOutput
Переопределяет:
write в классе FilterOutputStream
Параметры:
b - байт, который нужно записать.
Исключения:
IOException - если произошла ошибка ввода-вывода.
См. также:
  • FilterOutputStream.out

write

public void write(byte[] b, int off, int len) throws IOException
Записывает len байт из указанного массива байт, начиная с смещения off в базовый поток вывода. Если исключение не было выброшено, счётчик written увеличивается на len.
Определено в:
write в интерфейсе DataOutput
Переопределяет:
write в классе FilterOutputStream
Параметры:
b - данные.
off - начальное смещение в данных.
len - количество байт для записи.
Исключения:
IOException - если произошла ошибка ввода-вывода.
IndexOutOfBoundsException - Если off отрицательно, len отрицательно или len больше, чем b.length - off
См. также:
  • FilterOutputStream.out

flush

public void flush() throws IOException
Очищает этот поток вывода данных. Это принудительно записывает все буферизованные байты вывода в поток.

Метод flush класса DataOutputStream вызывает метод flush базового потока вывода.

Определено в:
flush в интерфейсе Flushable
Переопределяет:
flush в классе FilterOutputStream
Исключения:
IOException - если произошла ошибка ввода-вывода.
См. также:
  • FilterOutputStream.out
  • OutputStream.flush()

writeBoolean

public final void writeBoolean(boolean v) throws IOException
Записывает boolean в базовый поток вывода как значение 1 байт. Значение true записывается как значение (byte)1; значение false записывается как значение (byte)0. Если исключение не было выброшено, счётчик written увеличивается на 1.
Определено в:
writeBoolean в интерфейсе DataOutput
Параметры:
v - значение типа boolean для записи.
Исключения:
IOException - если произошла ошибка ввода-вывода.
См. также:
  • FilterOutputStream.out

writeByte

public final void writeByte(int v) throws IOException
Записывает byte в базовый поток вывода как значение 1 байт. Если исключение не было выброшено, счётчик written увеличивается на 1.
Определено в:
writeByte в интерфейсе DataOutput
Параметры:
v - значение типа byte для записи.
Исключения:
IOException - если произошла ошибка ввода-вывода.
См. также:
  • FilterOutputStream.out

writeShort

public final void writeShort(int v) throws IOException
Записывает short в базовый поток вывода как два байта, старший байт первым. Если исключение не было выброшено, счётчик written увеличивается на 2.
Определено в:
writeShort в интерфейсе DataOutput
Параметры:
v - значение типа short для записи.
Исключения:
IOException - если произошла ошибка ввода-вывода.
См. также:
  • FilterOutputStream.out

writeChar

public final void writeChar(int v) throws IOException
Записывает char в базовый поток вывода как значение 2 байта, старший байт первым. Если исключение не было выброшено, счётчик written увеличивается на 2.
Определено в:
writeChar в интерфейсе DataOutput
Параметры:
v - значение типа char для записи.
Исключения:
IOException - если произошла ошибка ввода-вывода.
См. также:
  • FilterOutputStream.out

writeInt

public final void writeInt(int v) throws IOException
Записывает int в базовый поток вывода как четыре байта, старший байт первым. Если исключение не было выброшено, счётчик written увеличивается на 4.
Определено в:
writeInt в интерфейсе DataOutput
Параметры:
v - значение типа int для записи.
Исключения:
IOException - если произошла ошибка ввода-вывода.
См. также:
  • FilterOutputStream.out

writeLong

public final void writeLong(long v) throws IOException
Записывает long в базовый поток вывода как восемь байт, старший байт первым. Если исключение не было выброшено, счётчик written увеличивается на 8.
Определено в:
writeLong в интерфейсе DataOutput
Параметры:
v - значение типа long для записи.
Исключения:
IOException - если произошла ошибка ввода-вывода.
См. также:
  • FilterOutputStream.out

writeFloat

public final void writeFloat(float v) throws IOException
Преобразует аргумент типа float в значение типа int с помощью метода floatToIntBits в классе Float, а затем записывает это значение в базовый поток вывода как 4-байтовое значение, старший байт первым. Если исключение не было выброшено, счётчик written увеличивается на 4.
Определено в:
writeFloat в интерфейсе DataOutput
Параметры:
v - значение типа float для записи.
Исключения:
IOException - если произошла ошибка ввода-вывода.
См. также:
  • FilterOutputStream.out
  • Float.floatToIntBits(float)

writeDouble

public final void writeDouble(double v) throws IOException
Преобразует аргумент типа double в значение типа long с помощью метода doubleToLongBits в классе Double, а затем записывает это значение в базовый поток вывода как 8-байтовое значение, старший байт первым. Если исключение не было выброшено, счётчик written увеличивается на 8.
Определено в:
writeDouble в интерфейсе DataOutput
Параметры:
v - значение типа double для записи.
Исключения:
IOException - если произошла ошибка ввода-вывода.
См. также:
  • FilterOutputStream.out
  • Double.doubleToLongBits(double)

writeBytes

public final void writeBytes(String s) throws IOException
Записывает строку в базовый выходной поток в виде последовательности байтов. Каждый символ в строке записывается последовательно, отбрасывая его старшие восемь бит. Если исключение не выброшено, счётчик written увеличивается на длину s.
Определено в:
writeBytes в интерфейсе DataOutput
Параметры:
s - строка байтов для записи.
Исключения:
IOException - если произошла ошибка ввода-вывода.
См. также:
  • FilterOutputStream.out

writeChars

public final void writeChars(String s) throws IOException
Записывает строку в базовый выходной поток в виде последовательности символов. Каждый символ записывается в поток данных, как если бы использовалась метод writeChar. Если исключение не выброшено, счётчик written увеличивается вдвое на длину s.
Определено в:
writeChars в интерфейсе DataOutput
Параметры:
s - значение String для записи.
Исключения:
IOException - если произошла ошибка ввода-вывода.
См. также:
  • writeChar(int)
  • FilterOutputStream.out

writeUTF

public final void writeUTF(String str) throws IOException
Записывает строку в базовый выходной поток, используя кодировку изменённый UTF-8 для независимой от машины записи.

Сначала в выходной поток записываются два байта, как если бы метод writeShort указывал на количество последующих байтов. Это значение равно количеству фактически записанных байтов, а не длине строки. После длины каждый символ строки выводится последовательно, используя изменённую кодировку UTF-8 для символа. Если исключение не выброшено, счётчик written увеличивается на общее количество записанных в выходной поток байтов. Это значение будет не меньше двух плюс длина str, и не больше двух плюс утроенной длины str.

Определено в:
writeUTF в интерфейсе DataOutput
Параметры:
str - строка для записи.
Исключения:
UTFDataFormatException - если кодировка изменённого UTF-8 для str превысит 65535 байт по длине
IOException - если произошла какая-либо другая ошибка ввода-вывода.
См. также:
  • writeChars(String)

size

public final int size()
Возвращает текущее значение счётчика written, количество байтов, записанных в этот поток данных до сих пор. Если счётчик переполнится, он будет переведён в Integer.MAX_VALUE.
Возвращает:
значение поля written.
См. также:
  • written

© 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/DataOutputStream.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API