Spec-Zone.ru › OpenJDK 17

Класс 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 - данные byte, которые будут записаны.
Исключения:
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 - если возникает ошибка ввода-вывода.
См. также:
  • 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, а затем записывает это значение int в базовый поток вывода как 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, а затем записывает это значение long в базовый поток вывода как 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
END_OF_DOCUMENT_MARKER

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, 2021, 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/17/docs/api/java.base/java/io/DataOutputStream.html

Spec-Zone.ru

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