public class OutputStreamWriter extends Writer
file.encoding
.
The only encodings that are guaranteed to be available are "8859_1"
(the Latin-1 character set) and "UTF8". Unfortunately, Java does not
provide a mechanism for listing the encodings that are supported in
a given implementation.
Here is a list of standard encoding names that may be available:
Constructor and Description |
---|
OutputStreamWriter(OutputStream out)
This method initializes a new instance of
OutputStreamWriter
to write to the specified stream using the default encoding. |
OutputStreamWriter(OutputStream out,
String encoding_name)
This method initializes a new instance of
OutputStreamWriter
to write to the specified stream using a caller supplied character
encoding scheme. |
Modifier and Type | Method and Description |
---|---|
void |
close()
This method closes this stream, and the underlying
OutputStream |
void |
flush()
This method flushes any buffered bytes to the underlying output sink.
|
String |
getEncoding()
This method returns the name of the character encoding scheme currently
in use by this stream.
|
void |
write(char[] chars,
int offset,
int length)
This method writes
count characters from the specified
array to the output stream starting at position offset
into the array. |
public OutputStreamWriter(OutputStream out, String encoding_name) throws UnsupportedEncodingException
OutputStreamWriter
to write to the specified stream using a caller supplied character
encoding scheme. Note that due to a deficiency in the Java language
design, there is no way to determine which encodings are supported.out
- The OutputStream
to write toencoding_name
- The name of the encoding scheme to use for
character to byte translationUnsupportedEncodingException
- If the named encoding is
not available.public OutputStreamWriter(OutputStream out)
OutputStreamWriter
to write to the specified stream using the default encoding.out
- The OutputStream
to write topublic void close() throws IOException
OutputStream
close
in class Writer
IOException
- If an error occurspublic String getEncoding()
null
.public void flush() throws IOException
flush
in class Writer
IOException
- If an error occurspublic void write(char[] chars, int offset, int length) throws IOException
count
characters from the specified
array to the output stream starting at position offset
into the array.write
in class Writer
buf
- The array of character to write fromoffset
- The offset into the array to start writing chars fromcount
- The number of chars to write.IOException
- If an error occurs