Класс PipedWriter

java.lang.Object

java.io.Writer

java.io.PipedWriter

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

public class PipedWriter extends Writer

Потоки вывода символов через канал.

Начиная с:: 1.1

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

Поля, объявленные в классе Writer

lock

Модификатор и тип	Поле	Описание
`protected Object`	`lock`	Объект, используемый для синхронизации операций над этим потоком.

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

Конструктор	Описание
`PipedWriter()`	Создает канальный писатель, еще не подключенный к канальному читателю.
`PipedWriter(PipedReader snk)`	Создает канальный писатель, подключенный к указанному канальному читателю.

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

Модификатор и тип	Метод	Описание
`void`	`close()`	Закрывает этот канальный поток вывода и освобождает все системные ресурсы, связанные с этим потоком.
`void`	`connect(PipedReader snk)`	Подключает этот канальный писатель к приемнику.
`void`	`flush()`	Сбрасывает этот поток вывода и принудительно записывает все буферизованные выходные символы.
`void`	`write(char[] cbuf, int off, int len)`	Записывает `len` символов из указанного массива символов, начиная со смещения `off`, в этот канальный поток вывода.
`void`	`write(int c)`	Записывает указанный `char` в канальный поток вывода.

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

append, append, append, nullWriter, write, write, write

Модификатор и тип	Метод	Описание
`Writer`	`append(char c)`	Добавляет указанный символ в этот объект записи.
`Writer`	`append(CharSequence csq)`	Добавляет указанную последовательность символов в этот объект записи.
`Writer`	`append(CharSequence csq, int start, int end)`	Добавляет подпоследовательность указанной последовательности символов в этот объект записи.
`static Writer`	`nullWriter()`	Возвращает новый `Writer`, отбрасывающий все символы.
`void`	`write(char[] cbuf)`	Записывает массив символов.
`void`	`write(String str)`	Записывает строку.
`void`	`write(String str, int off, int len)`	Записывает часть строки.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно посредством уведомления или прерывания, либо до истечения определенного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно посредством уведомления или прерывания, либо до истечения определенного промежутка реального времени.

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

PipedWriter

public PipedWriter(PipedReader snk) throws IOException

Создает канальный писатель, подключенный к указанному канальному читателю. Символы данных, записанные в этот поток, становятся доступными для чтения из snk.

Параметры:: snk — канальный читатель, к которому выполняется подключение.
Исключения:: IOException — если возникает ошибка ввода-вывода.

PipedWriter

public PipedWriter()

Создает канальный писатель, еще не подключенный к канальному читателю. Перед использованием его необходимо подключить к канальному читателю со стороны приемника или отправителя.

См. также:

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

connect

public void connect(PipedReader snk) throws IOException

Подключает этот канальный писатель к приемнику. Если этот объект уже подключен к другому канальному читателю, выбрасывается IOException.

Если snk — неподключенный канальный читатель, а src — неподключенный канальный писатель, их можно подключить одним из следующих вызовов:

    src.connect(snk)

или вызовом:

    snk.connect(src)

Оба вызова имеют одинаковый эффект.

Параметры:: snk — канальный читатель, к которому выполняется подключение.
Исключения:: IOException — если возникает ошибка ввода-вывода.

write

public void write(int c) throws IOException

Записывает указанный char в канальный поток вывода. Если поток, считывавший символы данных из подключенного канального входного потока, больше не активен, выбрасывается IOException.

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

Переопределяет:: write в классе Writer
Параметры:: c — char для записи.
Исключения:: IOException — если канал broken, unconnected, закрыт или возникает ошибка ввода-вывода.

write

public void write(char[] cbuf, int off, int len) throws IOException

Записывает len символов из указанного массива символов, начиная со смещения off, в этот канальный поток вывода. Этот метод блокируется до тех пор, пока все символы не будут записаны в поток вывода. Если поток, считывавший символы данных из подключенного канального входного потока, больше не активен, выбрасывается IOException.

Определено в:: write в классе Writer
Параметры:: cbuf — данные.; off — начальное смещение в данных.; len — количество символов для записи.
Исключения:: IndexOutOfBoundsException — если off отрицательно, или len отрицательно, или off + len отрицательно либо превышает длину заданного массива; IOException — если канал broken, unconnected, закрыт или возникает ошибка ввода-вывода.

flush

public void flush() throws IOException

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

Определено в:: flush в интерфейсе Flushable
Определено в:: flush в классе Writer
Исключения:: IOException — если канал закрыт или возникает ошибка ввода-вывода.

close

public void close() throws IOException

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

Определено в:: close в интерфейсе AutoCloseable
Определено в:: close в интерфейсе Closeable
Определено в:: close в классе Writer
Исключения:: 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.