Класс BufferedOutputStream

java.io.BufferedOutputStream

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

public class BufferedOutputStream extends FilterOutputStream

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

Примечание к API:: После обёртывания в BufferedOutputStream базовый OutputStream не следует использовать напрямую или оборачивать в другой поток.
Начиная с версии:: 1.0

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

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

Поля, объявленные в классе 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)`	Записывает указанный байт в этот буферизованный поток вывода.

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

close, write

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

nullOutputStream

Методы, объявленные в классе 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 — если возникает ошибка ввода-вывода.

IndexOutOfBoundsException — если off отрицательно, len отрицательно или len больше b.length - off

См. также:

flush

public void flush() throws IOException

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

Определён в:

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

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

flush в классе FilterOutputStream

Выбрасывает:

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

См. также:

© 1993, 2025, 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/25/docs/api/java.base/java/io/BufferedOutputStream.html