Класс BufferedOutputStream

java.io.BufferedOutputStream

Все реализованные интерфейсы:: Closeable, Flushable, AutoCloseable

public class BufferedOutputStream extends FilterOutputStream

Класс реализует буферизованный выходной поток. Создавая такой выходной поток, приложение может записывать байты в основной выходной поток, не вызывая при этом вызов основной системы для каждого записанного байта.

С момента:: 1.0

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

Модификатор и тип	Поле	Описание
`protected byte[]`	`buf`	Внутренний буфер, где хранятся данные.
`protected int`	`count`	Количество допустимых байтов в буфере.

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

out

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

Конструктор	Описание
`BufferedOutputStream(OutputStream out)`	Создает новый буферизованный выходной поток для записи данных в указанный основной выходной поток.
`BufferedOutputStream(OutputStream out, int size)`	Создает новый буферизованный выходной поток для записи данных в указанный основной выходной поток с заданным размером буфера.

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

Модификатор и тип	Метод	Описание
`void`	`flush()`	Очищает этот буферизованный выходной поток.
`void`	`write(byte[] b, int off, int len)`	Записывает `len` байтов из указанного массива байтов, начиная с смещения `off`, в этот буферизованный выходной поток.
`void`	`write(int b)`	Записывает указанный байт в этот буферизованный выходной поток.

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

close, write

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

nullOutputStream

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

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

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

buf

protected byte[] buf

Внутренний буфер, где хранятся данные.

count

protected int count

Количество допустимых байтов в буфере. Это значение всегда находится в диапазоне 0 до buf.length; элементы buf[0] по buf[count-1] содержат допустимые данные байтов.

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

BufferedOutputStream

public BufferedOutputStream(OutputStream out)

Создает новый буферизованный выходной поток для записи данных в указанный основной выходной поток.

Параметры:: out - основной выходной поток.

BufferedOutputStream

public BufferedOutputStream(OutputStream out, int size)

Создает новый буферизованный выходной поток для записи данных в указанный основной выходной поток с заданным размером буфера.

Параметры:: out - основной выходной поток.; size - размер буфера.
Исключения:: IllegalArgumentException - если size <= 0.

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

write

public void write(int b) throws IOException

Записывает указанный байт в этот буферизованный выходной поток.

Переопределяет:: write в классе FilterOutputStream
Параметры:: b - байт для записи.
Исключения:: IOException - если возникает ошибка ввода-вывода.

write

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

Записывает len байтов из указанного массива байтов, начиная с смещения off, в этот буферизованный выходной поток.

Обычно этот метод записывает байты из данного массива в буфер этого потока, очищая буфер в основной выходной поток по мере необходимости. Однако, если запрошенная длина не меньше размера буфера этого потока, этот метод очистит буфер и запишет байты непосредственно в основной выходной поток. Таким образом, избыточные BufferedOutputStream не будут копировать данные бесполезно.

Переопределяет:

write в классе FilterOutputStream

Параметры:

b - данные.

off - начальное смещение в данных.

len - количество байтов для записи.

Исключения:

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

См. также:

FilterOutputStream.write(int)

flush

public void flush() throws IOException

Очищает этот буферизованный выходной поток. Это заставляет любые буферизованные выходные байты быть записанными в основной выходной поток.

Определено в:

flush в интерфейсе Flushable

Переопределяет:

flush в классе FilterOutputStream

Исключения:

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

См. также:

FilterOutputStream.out

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