|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.io.Writer | +--java.io.OutputStreamWriter
Write characters to an output stream, translating characters into bytes according to a specified character encoding. Each OutputStreamWriter incorporates its own CharToByteConverter, and is thus a bridge from character streams to byte streams.
The encoding used by an OutputStreamWriter may be specified by name, by providing a CharToByteConverter, or by accepting the default encoding, which is defined by the system property file.encoding.
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. The size of this buffer may be specified, but by default it is large enough for most purposes. 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));
BufferedWriter
,
OutputStream
Field Summary | |
private byte[] |
bb
|
private sun.io.CharToByteConverter |
ctb
|
private static int |
defaultByteBufferSize
|
private int |
nBytes
|
private int |
nextByte
|
private OutputStream |
out
|
Fields inherited from class java.io.Writer |
lock,
writeBuffer,
writeBufferSize |
Constructor Summary | |
|
OutputStreamWriter(OutputStream out)
Create an OutputStreamWriter that uses the default character encoding. |
private |
OutputStreamWriter(OutputStream out,
sun.io.CharToByteConverter ctb)
Create an OutputStreamWriter that uses the specified character-to-byte converter. |
|
OutputStreamWriter(OutputStream out,
String enc)
Create an OutputStreamWriter that uses the named character encoding. |
Method Summary | |
void |
close()
Close the stream. |
private void |
ensureOpen()
Check to make sure that the stream has not been closed |
void |
flush()
Flush the stream. |
(package private) void |
flushBuffer()
Flush the output buffer to the underlying byte stream, without flushing the byte stream itself. |
String |
getEncoding()
Returns the canonical name of the character encoding being used by this stream. |
void |
write(char[] cbuf,
int off,
int len)
Write a portion of an array of characters. |
void |
write(int c)
Write a single character. |
void |
write(String str,
int off,
int len)
Write a portion of a string. |
Methods inherited from class java.io.Writer |
write,
write |
Methods inherited from class java.lang.Object |
|
Field Detail |
private sun.io.CharToByteConverter ctb
private OutputStream out
private static final int defaultByteBufferSize
private byte[] bb
private int nextByte
private int nBytes
Constructor Detail |
public OutputStreamWriter(OutputStream out, String enc) throws UnsupportedEncodingException
out
- An OutputStreamenc
- Name of the encoding to be usedpublic OutputStreamWriter(OutputStream out)
out
- An OutputStreamprivate OutputStreamWriter(OutputStream out, sun.io.CharToByteConverter ctb)
out
- An OutputStreamctb
- A CharToByteConverterMethod Detail |
public String getEncoding()
OutputStreamWriter
was created
with the OutputStreamWriter(OutputStream, String)
constructor,
the returned encoding name, being canonical, may differ from the
encoding name passed to the constructor. May return null
if the stream has been closed.private void ensureOpen() throws IOException
public void write(int c) throws IOException
public void write(char[] cbuf, int off, int len) throws IOException
cbuf
- Buffer of charactersoff
- Offset from which to start writing characterslen
- Number of characters to writepublic void write(String str, int off, int len) throws IOException
str
- A Stringoff
- Offset from which to start writing characterslen
- Number of characters to writevoid flushBuffer() throws IOException
public void flush() throws IOException
public void close() throws IOException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |