Класс PipedWriter

java.lang.Object
- java.io.Writer
- - java.io.PipedWriter

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

public class PipedWriter
extends Writer

Потоковые потоки символьного вывода.

С момента:: 1.1

Поля

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

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` в поток вывода.

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

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

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

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

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

PipedWriter

public PipedWriter(PipedReader snk)
            throws IOException

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

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

PipedWriter

public PipedWriter()

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

См. также:: PipedReader.connect(java.io.PipedWriter), connect(java.io.PipedReader)

Методы

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 - символ для записи.
Исключения:: 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 - если произошла ошибка ввода-вывода.