<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<!--NewPage-->
<html>
<head>
<!-- Generated by javadoc on Wed Jul 28 01:21:15 GMT 1999 -->
<title>
  Class java.io.OutputStreamWriter
</title>
</head>
<body>
<a name="_top_"></a>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.io.html">This Package</a>  <a href="java.io.OutputStream.html#_top_">Previous</a>  <a href="java.io.PipedInputStream.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
<hr>
<h1>
  Class java.io.OutputStreamWriter
</h1>
<pre>
<a href="java.lang.Object.html#_top_">java.lang.Object</a>
   |
   +----<a href="java.io.Writer.html#_top_">java.io.Writer</a>
           |
           +----java.io.OutputStreamWriter
</pre>
<hr>
<dl>
  <dt> public class <b>OutputStreamWriter</b>
  <dt> extends <a href="java.io.Writer.html#_top_">Writer</a>
</dl>
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.
 <p> 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 <tt>file.encoding</tt>.
 <p> 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,
 <pre>
 Writer out
   = new BufferedWriter(new OutputStreamWriter(System.out));
 </pre>
<p>
<dl>
    <dt> <b>See Also:</b>
    <dd> <a href="java.io.BufferedWriter.html#_top_">BufferedWriter</a>, <a href="java.io.OutputStream.html#_top_">OutputStream</a>
</dl>
<hr>
<a name="index"></a>
<h2>
  <img src="images/constructor-index.gif" width=275 height=38 alt="Constructor Index">
</h2>
<dl>
  <dt> <img src="images/yellow-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#OutputStreamWriter(java.io.OutputStream)"><b>OutputStreamWriter</b></a>(OutputStream)
  <dd>  Create an OutputStreamWriter that uses the default character encoding.
  <dt> <img src="images/yellow-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#OutputStreamWriter(java.io.OutputStream, java.lang.String)"><b>OutputStreamWriter</b></a>(OutputStream, String)
  <dd>  Create an OutputStreamWriter that uses the named character encoding.
</dl>
<h2>
  <img src="images/method-index.gif" width=207 height=38 alt="Method Index">
</h2>
<dl>
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#close()"><b>close</b></a>()
  <dd>  Close the stream.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#flush()"><b>flush</b></a>()
  <dd>  Flush the stream.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getEncoding()"><b>getEncoding</b></a>()
  <dd>  Return the name of the encoding being used by this stream.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#write(char[], int, int)"><b>write</b></a>(char[], int, int)
  <dd>  Write a portion of an array of characters.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#write(int)"><b>write</b></a>(int)
  <dd>  Write a single character.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#write(java.lang.String, int, int)"><b>write</b></a>(String, int, int)
  <dd>  Write a portion of a string.
</dl>
<a name="constructors"></a>
<h2>
  <img src="images/constructors.gif" width=231 height=38 alt="Constructors">
</h2>
<a name="OutputStreamWriter"></a>
<a name="OutputStreamWriter(java.io.OutputStream, java.lang.String)"><img src="images/yellow-ball.gif" width=12 height=12 alt=" o "></a>
<b>OutputStreamWriter</b>
<pre>
 public OutputStreamWriter(<a href="java.io.OutputStream.html#_top_">OutputStream</a> out,
                           <a href="java.lang.String.html#_top_">String</a> enc) throws <a href="java.io.UnsupportedEncodingException.html#_top_">UnsupportedEncodingException</a>
</pre>
<dl>
  <dd> Create an OutputStreamWriter that uses the named character encoding.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> out - An OutputStream
    <dd> enc - Name of the encoding to be used
    <dt> <b>Throws:</b> <a href="java.io.UnsupportedEncodingException.html#_top_">UnsupportedEncodingException</a>
    <dd> If the named encoding is not supported
  </dl></dd>
</dl>
<a name="OutputStreamWriter(java.io.OutputStream)"><img src="images/yellow-ball.gif" width=12 height=12 alt=" o "></a>
<b>OutputStreamWriter</b>
<pre>
 public OutputStreamWriter(<a href="java.io.OutputStream.html#_top_">OutputStream</a> out)
</pre>
<dl>
  <dd> Create an OutputStreamWriter that uses the default character encoding.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> out - An OutputStream
  </dl></dd>
</dl>
<a name="methods"></a>
<h2>
  <img src="images/methods.gif" width=151 height=38 alt="Methods">
</h2>
<a name="getEncoding()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getEncoding"><b>getEncoding</b></a>
<pre>
 public <a href="java.lang.String.html#_top_">String</a> getEncoding()
</pre>
<dl>
  <dd> Return the name of the encoding being used by this stream.  May return
 null if the stream has been closed.
<p>
</dl>
<a name="write(int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="write"><b>write</b></a>
<pre>
 public void write(int c) throws <a href="java.io.IOException.html#_top_">IOException</a>
</pre>
<dl>
  <dd> Write a single character.
<p>
  <dd><dl>
    <dt> <b>Throws:</b> <a href="java.io.IOException.html#_top_">IOException</a>
    <dd> If an I/O error occurs
    <dt> <b>Overrides:</b>
    <dd> <a href="java.io.Writer.html#write(int)">write</a> in class <a href="java.io.Writer.html#_top_">Writer</a>
  </dl></dd>
</dl>
<a name="write(char[], int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="write"><b>write</b></a>
<pre>
 public void write(char cbuf[],
                   int off,
                   int len) throws <a href="java.io.IOException.html#_top_">IOException</a>
</pre>
<dl>
  <dd> Write a portion of an array of characters.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> cbuf - Buffer of characters
    <dd> off - Offset from which to start writing characters
    <dd> len - Number of characters to write
    <dt> <b>Throws:</b> <a href="java.io.IOException.html#_top_">IOException</a>
    <dd> If an I/O error occurs
    <dt> <b>Overrides:</b>
    <dd> <a href="java.io.Writer.html#write(char[], int, int)">write</a> in class <a href="java.io.Writer.html#_top_">Writer</a>
  </dl></dd>
</dl>
<a name="write(java.lang.String, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="write"><b>write</b></a>
<pre>
 public void write(<a href="java.lang.String.html#_top_">String</a> str,
                   int off,
                   int len) throws <a href="java.io.IOException.html#_top_">IOException</a>
</pre>
<dl>
  <dd> Write a portion of a string.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> str - A String
    <dd> off - Offset from which to start writing characters
    <dd> len - Number of characters to write
    <dt> <b>Throws:</b> <a href="java.io.IOException.html#_top_">IOException</a>
    <dd> If an I/O error occurs
    <dt> <b>Overrides:</b>
    <dd> <a href="java.io.Writer.html#write(java.lang.String, int, int)">write</a> in class <a href="java.io.Writer.html#_top_">Writer</a>
  </dl></dd>
</dl>
<a name="flush()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="flush"><b>flush</b></a>
<pre>
 public void flush() throws <a href="java.io.IOException.html#_top_">IOException</a>
</pre>
<dl>
  <dd> Flush the stream.
<p>
  <dd><dl>
    <dt> <b>Throws:</b> <a href="java.io.IOException.html#_top_">IOException</a>
    <dd> If an I/O error occurs
    <dt> <b>Overrides:</b>
    <dd> <a href="java.io.Writer.html#flush()">flush</a> in class <a href="java.io.Writer.html#_top_">Writer</a>
  </dl></dd>
</dl>
<a name="close()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="close"><b>close</b></a>
<pre>
 public void close() throws <a href="java.io.IOException.html#_top_">IOException</a>
</pre>
<dl>
  <dd> Close the stream.
<p>
  <dd><dl>
    <dt> <b>Throws:</b> <a href="java.io.IOException.html#_top_">IOException</a>
    <dd> If an I/O error occurs
    <dt> <b>Overrides:</b>
    <dd> <a href="java.io.Writer.html#close()">close</a> in class <a href="java.io.Writer.html#_top_">Writer</a>
  </dl></dd>
</dl>
<hr>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.io.html">This Package</a>  <a href="java.io.OutputStream.html#_top_">Previous</a>  <a href="java.io.PipedInputStream.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>
