java.io
Class OutputStreamWriter
java.lang.Object
|
+--java.io.Writer
|
+--java.io.OutputStreamWriter
public class
OutputStreamWriterextends
Writer This class writes characters to an output stream that is byte oriented
It converts the chars that are written to bytes using an encoding layer,
which is specific to a particular encoding standard. The desired
encoding can either be specified by name, or if no encoding is specified,
the system default encoding will be used. The system default encoding
name is determined from the system property
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:
- 8859_1 (ISO-8859-1/Latin-1)
- 8859_2 (ISO-8859-2/Latin-2)
- 8859_3 (ISO-8859-3/Latin-3)
- 8859_4 (ISO-8859-4/Latin-4)
- 8859_5 (ISO-8859-5/Latin-5)
- 8859_6 (ISO-8859-6/Latin-6)
- 8859_7 (ISO-8859-7/Latin-7)
- 8859_8 (ISO-8859-8/Latin-8)
- 8859_9 (ISO-8859-9/Latin-9)
- ASCII (7-bit ASCII)
- UTF8 (UCS Transformation Format-8)
- More Later
Author:- Aaron M. Renn (arenn@urbanophile.com)
OutputStreamWriter
public OutputStreamWriter(java.io.OutputStream out)
This method initializes a new instance of OutputStreamWriter
to write to the specified stream using the default encoding.
Parameters:
OutputStreamWriter
public OutputStreamWriter(java.io.OutputStream out, java.lang.String encoding_scheme)
This method initializes a new instance of 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.
Parameters:
Throws:
close
public void close()
This method closes this stream, and the underlying OutputStream
Throws:
flush
public void flush()
This method flushes any buffered bytes to the underlying output sink.
Throws:
getEncoding
public String getEncoding()
This method returns the name of the character encoding scheme currently
in use by this stream. If the stream has been closed, then this method
may return null
.
Returns:
write
public void write(char[] buf, int offset, int len)
This method writes len
characters from the specified
array to the output stream starting at position offset
into the array.
Parameters:
Throws:
write
public void write(int c)
This method writes a single character to the output stream.
Parameters:
Throws:
write
public void write(java.lang.String str, int offset, int len)
This method writes len
bytes from the specified
String
starting at position offset
into the
String
.
Parameters:
Throws:
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: