Closeable
, Flushable
, Appendable
, AutoCloseable
BufferedWriter
, CharArrayWriter
, FilterWriter
, OutputStreamWriter
, PipedWriter
, PrintWriter
, StringWriter
public abstract class Writer extends Object implements Appendable, Closeable, Flushable
Modifier and Type | Field | Description |
---|---|---|
protected Object |
lock |
The object used to synchronize operations on this stream. |
Modifier | Constructor | Description |
---|---|---|
protected |
Creates a new character-stream writer whose critical sections will synchronize on the writer itself. |
|
protected |
Creates a new character-stream writer whose critical sections will synchronize on the given object. |
Modifier and Type | Method | Description |
---|---|---|
Writer |
append |
Appends the specified character to this writer. |
Writer |
append |
Appends the specified character sequence to this writer. |
Writer |
append |
Appends a subsequence of the specified character sequence to this writer. |
abstract void |
close() |
Closes the stream, flushing it first. |
abstract void |
flush() |
Flushes the stream. |
static Writer |
nullWriter() |
Returns a new Writer which discards all characters. |
void |
write |
Writes an array of characters. |
abstract void |
write |
Writes a portion of an array of characters. |
void |
write |
Writes a single character. |
void |
write |
Writes a string. |
void |
write |
Writes a portion of a string. |
protected Object lock
this
or a synchronized method.protected Writer()
protected Writer(Object lock)
lock
- Object to synchronize onpublic static Writer nullWriter()
Writer
which discards all characters. The returned stream is initially open. The stream is closed by calling the close()
method. Subsequent calls to close()
have no effect. While the stream is open, the append(char)
,
append(CharSequence)
, append(CharSequence, int, int)
, flush()
, write(int)
, write(char[])
, and write(char[], int, int)
methods do nothing. After the stream has been closed, these methods all throw IOException
.
The object
used to synchronize operations on the returned Writer
is not specified.
Writer
which discards all characterspublic void write(int c) throws IOException
Subclasses that intend to support efficient single-character output should override this method.
c
- int specifying a character to be writtenIOException
- If an I/O error occurspublic void write(char[] cbuf) throws IOException
cbuf
- Array of characters to be writtenIOException
- If an I/O error occurspublic abstract void write(char[] cbuf, int off, int len) throws IOException
cbuf
- Array of charactersoff
- Offset from which to start writing characterslen
- Number of characters to writeIndexOutOfBoundsException
- Implementations should throw this exception if off
is negative, or len
is negative, or off + len
is negative or greater than the length of the given arrayIOException
- If an I/O error occurspublic void write(String str) throws IOException
str
- String to be writtenIOException
- If an I/O error occurspublic void write(String str, int off, int len) throws IOException
IndexOutOfBoundsException
for the indicated conditions; overriding methods may choose to do otherwise.str
- A Stringoff
- Offset from which to start writing characterslen
- Number of characters to writeIndexOutOfBoundsException
- Implementations should throw this exception if off
is negative, or len
is negative, or off + len
is negative or greater than the length of the given stringIOException
- If an I/O error occurspublic Writer append(CharSequence csq) throws IOException
An invocation of this method of the form out.append(csq)
behaves in exactly the same way as the invocation
out.write(csq.toString())
Depending on the specification of toString
for the character sequence csq
, the entire sequence may not be appended. For instance, invoking the toString
method of a character buffer will return a subsequence whose content depends upon the buffer's position and limit.
append
in interface Appendable
csq
- The character sequence to append. If csq
is null
, then the four characters "null"
are appended to this writer.IOException
- If an I/O error occurspublic Writer append(CharSequence csq, int start, int end) throws IOException
Appendable
. An invocation of this method of the form out.append(csq, start, end)
when csq
is not null
behaves in exactly the same way as the invocation
out.write(csq.subSequence(start, end).toString())
append
in interface Appendable
csq
- The character sequence from which a subsequence will be appended. If csq
is null
, then characters will be appended as if csq
contained the four characters "null"
.start
- The index of the first character in the subsequenceend
- The index of the character following the last character in the subsequenceIndexOutOfBoundsException
- If start
or end
are negative, start
is greater than end
, or end
is greater than csq.length()
IOException
- If an I/O error occurspublic Writer append(char c) throws IOException
An invocation of this method of the form out.append(c)
behaves in exactly the same way as the invocation
out.write(c)
append
in interface Appendable
c
- The 16-bit character to appendIOException
- If an I/O error occurspublic abstract void flush() throws IOException
If the intended destination of this stream is an abstraction provided by the underlying operating system, for example a file, then flushing the stream guarantees only that bytes previously written to the stream are passed to the operating system for writing; it does not guarantee that they are actually written to a physical device such as a disk drive.
flush
in interface Flushable
IOException
- If an I/O error occurspublic abstract void close() throws IOException
close
in interface AutoCloseable
close
in interface Closeable
IOException
- If an I/O error occurs
© 1993, 2023, 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/21/docs/api/java.base/java/io/Writer.html