|
FlexDoc/Javadoc 2.0 Demo Java Doc |
Each invocation of a write() method causes the encoding converter to be invoked on the given character(s). The resulting bytes are accumulated in a buffer before being written to the underlying output stream. Note that the characters passed to the write() methods are not buffered.
For top efficiency, consider wrapping an OutputStreamWriter within a BufferedWriter so as to avoid frequent converter invocations. For example:
Writer out = new BufferedWriter(new OutputStreamWriter(System.out));
A surrogate pair is a character represented by a sequence of two char values: A high surrogate in the range '\uD800' to '\uDBFF' followed by a low surrogate in the range '\uDC00' to '\uDFFF'.
A malformed surrogate element is a high surrogate that is not followed by a low surrogate or a low surrogate that is not preceded by a high surrogate.
This class always replaces malformed surrogate elements and unmappable character sequences with the charset's default substitution sequence. The CharsetEncoder class should be used when more control over the encoding process is required.
Field Summary |
Fields inherited from class java.io.Writer |
Constructor Summary |
||
Creates an OutputStreamWriter that uses the default character encoding.
|
||
Creates an OutputStreamWriter that uses the given charset.
|
||
Creates an OutputStreamWriter that uses the given charset encoder.
|
||
Creates an OutputStreamWriter that uses the named charset.
|
Method Summary |
||
append(CharSequence csq)
Appends the specified character sequence to this writer.
|
||
append(CharSequence csq, int start, int end)
Appends a subsequence of the specified character sequence to this writer.
|
||
void |
close()
Closes the stream, flushing it first.
|
|
void |
flush()
Flushes the stream.
|
|
Returns the name of the character encoding being used by this stream.
|
||
void |
write(char[] cbuf, int off, int len)
Writes a portion of an array of characters.
|
|
void |
write(int c)
Writes a single character.
|
|
void |
Writes a portion of a string.
|
Methods inherited from class java.io.Writer |
Methods inherited from class java.lang.Object |
public OutputStreamWriter |
|
throws |
public OutputStreamWriter |
(OutputStream out) |
public OutputStreamWriter |
public OutputStreamWriter |
public String getEncoding |
() |
If the encoding has an historical name then that name is returned; otherwise the encoding's canonical name is returned.
If this instance was created with the OutputStreamWriter(OutputStream, String) constructor then the returned name, being unique for the encoding, may differ from the name passed to the constructor. This method may return null if the stream has been closed.
public void write |
(int c) |
throws |
public void write |
(char[] cbuf, int off, int len) |
throws |
public void write |
|
throws |
public Writer append |
|
throws |
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())
public Writer append |
(CharSequence csq) |
throws |
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.
public void flush |
() |
throws |
public void close |
() |
throws |
|
FlexDoc/Javadoc 2.0 Demo Java Doc |