- java.lang.Object
-
- java.io.Reader
-
- java.io.PipedReader
-
- All Implemented Interfaces:
- Closeable, AutoCloseable, Readable
public class PipedReader extends Reader
Piped character-input streams.- Since:
- JDK1.1
-
-
Field Summary
-
Fields inherited from class java.io.Reader
lock
-
-
Constructor Summary
Constructors Constructor and Description PipedReader()
Creates aPipedReader
so that it is not yet connected.PipedReader(int pipeSize)
Creates aPipedReader
so that it is not yetconnected
and uses the specified pipe size for the pipe's buffer.PipedReader(PipedWriter src)
Creates aPipedReader
so that it is connected to the piped writersrc
.PipedReader(PipedWriter src, int pipeSize)
Creates aPipedReader
so that it is connected to the piped writersrc
and uses the specified pipe size for the pipe's buffer.
-
Method Summary
Methods Modifier and Type Method and Description void
close()
Closes this piped stream and releases any system resources associated with the stream.void
connect(PipedWriter src)
Causes this piped reader to be connected to the piped writersrc
.int
read()
Reads the next character of data from this piped stream.int
read(char[] cbuf, int off, int len)
Reads up tolen
characters of data from this piped stream into an array of characters.boolean
ready()
Tell whether this stream is ready to be read.
-
-
-
Constructor Detail
-
PipedReader
public PipedReader(PipedWriter src) throws IOException
Creates aPipedReader
so that it is connected to the piped writersrc
. Data written tosrc
will then be available as input from this stream.- Parameters:
src
- the stream to connect to.- Throws:
IOException
- if an I/O error occurs.
-
PipedReader
public PipedReader(PipedWriter src, int pipeSize) throws IOException
Creates aPipedReader
so that it is connected to the piped writersrc
and uses the specified pipe size for the pipe's buffer. Data written tosrc
will then be available as input from this stream.- Parameters:
src
- the stream to connect to.pipeSize
- the size of the pipe's buffer.- Throws:
IOException
- if an I/O error occurs.IllegalArgumentException
- ifpipeSize <= 0
.- Since:
- 1.6
-
PipedReader
public PipedReader()
-
PipedReader
public PipedReader(int pipeSize)
Creates aPipedReader
so that it is not yetconnected
and uses the specified pipe size for the pipe's buffer. It must be connected to aPipedWriter
before being used.- Parameters:
pipeSize
- the size of the pipe's buffer.- Throws:
IllegalArgumentException
- ifpipeSize <= 0
.- Since:
- 1.6
-
-
Method Detail
-
connect
public void connect(PipedWriter src) throws IOException
Causes this piped reader to be connected to the piped writersrc
. If this object is already connected to some other piped writer, anIOException
is thrown.If
src
is an unconnected piped writer andsnk
is an unconnected piped reader, they may be connected by either the call:snk.connect(src)
or the call:
src.connect(snk)
The two calls have the same effect.
- Parameters:
src
- The piped writer to connect to.- Throws:
IOException
- if an I/O error occurs.
-
read
public int read() throws IOException
Reads the next character of data from this piped stream. If no character is available because the end of the stream has been reached, the value-1
is returned. This method blocks until input data is available, the end of the stream is detected, or an exception is thrown.- Overrides:
read
in classReader
- Returns:
- the next character of data, or
-1
if the end of the stream is reached. - Throws:
IOException
- if the pipe isbroken
,unconnected
, closed, or an I/O error occurs.
-
read
public int read(char[] cbuf, int off, int len) throws IOException
Reads up tolen
characters of data from this piped stream into an array of characters. Less thanlen
characters will be read if the end of the data stream is reached or iflen
exceeds the pipe's buffer size. This method blocks until at least one character of input is available.- Specified by:
read
in classReader
- Parameters:
cbuf
- the buffer into which the data is read.off
- the start offset of the data.len
- the maximum number of characters read.- Returns:
- the total number of characters read into the buffer, or
-1
if there is no more data because the end of the stream has been reached. - Throws:
IOException
- if the pipe isbroken
,unconnected
, closed, or an I/O error occurs.
-
ready
public boolean ready() throws IOException
Tell whether this stream is ready to be read. A piped character stream is ready if the circular buffer is not empty.- Overrides:
ready
in classReader
- Returns:
- True if the next read() is guaranteed not to block for input, false otherwise. Note that returning false does not guarantee that the next read will block.
- Throws:
IOException
- if the pipe isbroken
,unconnected
, or closed.
-
close
public void close() throws IOException
Closes this piped stream and releases any system resources associated with the stream.- Specified by:
close
in interfaceCloseable
- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in classReader
- Throws:
IOException
- if an I/O error occurs.
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-java/io/PipedReader.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.