<!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.FilterOutputStream
</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.FilterInputStream.html#_top_">Previous</a>  <a href="java.io.FilterReader.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
<hr>
<h1>
  Class java.io.FilterOutputStream
</h1>
<pre>
<a href="java.lang.Object.html#_top_">java.lang.Object</a>
   |
   +----<a href="java.io.OutputStream.html#_top_">java.io.OutputStream</a>
           |
           +----java.io.FilterOutputStream
</pre>
<hr>
<dl>
  <dt> public class <b>FilterOutputStream</b>
  <dt> extends <a href="java.io.OutputStream.html#_top_">OutputStream</a>
</dl>
This class is the superclass of all classes that filter output 
 streams. These streams sit on top of an already existing output 
 stream (the <i>underlying</i> output stream), but provide 
 additional functionality. 
 <p>
 The class <code>FilterOutputStream</code> itself simply overrides 
 all methods of <code>OutputStream</code> with versions that pass 
 all requests to the underlying output stream. Subclasses of 
 <code>FilterOutputStream</code> may further override some of these 
 methods as well as provide additional methods and fields.
<p>
<hr>
<a name="index"></a>
<h2>
  <img src="images/variable-index.gif" width=207 height=38 alt="Variable Index">
</h2>
<dl>
  <dt> <img src="images/magenta-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#out"><b>out</b></a>
  <dd>  The underlying output stream.
</dl>
<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="#FilterOutputStream(java.io.OutputStream)"><b>FilterOutputStream</b></a>(OutputStream)
  <dd>  Creates an output stream filter built on top of the specified 
 underlying output stream.
</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>  Closes this output stream and releases any system resources 
 associated with the stream.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#flush()"><b>flush</b></a>()
  <dd>  Flushes this output stream and forces any buffered output bytes 
 to be written out to the stream.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#write(byte[])"><b>write</b></a>(byte[])
  <dd>  Writes <code>b.length</code> bytes to this output stream.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#write(byte[], int, int)"><b>write</b></a>(byte[], int, int)
  <dd>  Writes <code>len</code> bytes from the specified 
 <code>byte</code> array starting at offset <code>off</code> to 
 this output stream.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#write(int)"><b>write</b></a>(int)
  <dd>  Writes the specified <code>byte</code> to this output stream.
</dl>
<a name="variables"></a>
<h2>
  <img src="images/variables.gif" width=153 height=38 alt="Variables">
</h2>
<a name="out"><img src="images/magenta-ball.gif" width=12 height=12 alt=" o "></a>
<b>out</b>
<pre>
 protected <a href="java.io.OutputStream.html#_top_">OutputStream</a> out
</pre>
<dl>
  <dd> The underlying output stream.<p>
</dl>
<a name="constructors"></a>
<h2>
  <img src="images/constructors.gif" width=231 height=38 alt="Constructors">
</h2>
<a name="FilterOutputStream"></a>
<a name="FilterOutputStream(java.io.OutputStream)"><img src="images/yellow-ball.gif" width=12 height=12 alt=" o "></a>
<b>FilterOutputStream</b>
<pre>
 public FilterOutputStream(<a href="java.io.OutputStream.html#_top_">OutputStream</a> out)
</pre>
<dl>
  <dd> Creates an output stream filter built on top of the specified 
 underlying output stream.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> out - the underlying output stream.
  </dl></dd>
</dl>
<a name="methods"></a>
<h2>
  <img src="images/methods.gif" width=151 height=38 alt="Methods">
</h2>
<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 b) throws <a href="java.io.IOException.html#_top_">IOException</a>
</pre>
<dl>
  <dd> Writes the specified <code>byte</code> to this output stream. 
 <p>
 The <code>write</code> method of <code>FilterOutputStream</code> 
 calls the <code>write</code> method of its underlying output stream.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> b - the <code>byte</code>.
    <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.OutputStream.html#write(int)">write</a> in class <a href="java.io.OutputStream.html#_top_">OutputStream</a>
  </dl></dd>
</dl>
<a name="write(byte[])"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="write"><b>write</b></a>
<pre>
 public void write(byte b[]) throws <a href="java.io.IOException.html#_top_">IOException</a>
</pre>
<dl>
  <dd> Writes <code>b.length</code> bytes to this output stream. 
 <p>
 The <code>write</code> method of <code>FilterOutputStream</code> 
 calls its <code>write</code> method of three arguments with the 
 arguments <code>b</code>, <code>0</code>, and 
 <code>b.length</code>. 
 <p>
 Note that this method does not call the one-argument 
 <code>write</code> method of its underlying stream with the single 
 argument <code>b</code>.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> b - the data to be written.
    <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.OutputStream.html#write(byte[])">write</a> in class <a href="java.io.OutputStream.html#_top_">OutputStream</a>
    <dt> <b>See Also:</b>
    <dd> <a href="#write(byte[], int, int)">write</a>
  </dl></dd>
</dl>
<a name="write(byte[], 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(byte b[],
                   int off,
                   int len) throws <a href="java.io.IOException.html#_top_">IOException</a>
</pre>
<dl>
  <dd> Writes <code>len</code> bytes from the specified 
 <code>byte</code> array starting at offset <code>off</code> to 
 this output stream. 
 <p>
 The <code>write</code> method of <code>FilterOutputStream</code> 
 calls the <code>write</code> method of one argument on each 
 <code>byte</code> to output. 
 <p>
 Note that this method does not call the <code>write</code> method 
 of its underlying input stream with the same arguments. Subclasses 
 of <code>FilterOutputStream</code> should provide a more efficient 
 implementation of this method.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> b - the data.
    <dd> off - the start offset in the data.
    <dd> len - the number of bytes 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.OutputStream.html#write(byte[], int, int)">write</a> in class <a href="java.io.OutputStream.html#_top_">OutputStream</a>
    <dt> <b>See Also:</b>
    <dd> <a href="#write(int)">write</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> Flushes this output stream and forces any buffered output bytes 
 to be written out to the stream. 
 <p>
 The <code>flush</code> method of <code>FilterOutputStream</code> 
 calls the <code>flush</code> method of its underlying output 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.OutputStream.html#flush()">flush</a> in class <a href="java.io.OutputStream.html#_top_">OutputStream</a>
    <dt> <b>See Also:</b>
    <dd> <a href="#out">out</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> Closes this output stream and releases any system resources 
 associated with the stream. 
 <p>
 The <code>close</code> method of <code>FilterOutputStream</code> 
 calls its <code>flush</code> method, and then calls the 
 <code>close</code> method of its underlying output 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.OutputStream.html#close()">close</a> in class <a href="java.io.OutputStream.html#_top_">OutputStream</a>
    <dt> <b>See Also:</b>
    <dd> <a href="#flush()">flush</a>, <a href="#out">out</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.FilterInputStream.html#_top_">Previous</a>  <a href="java.io.FilterReader.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>
