<!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.PushbackReader
</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.PushbackInputStream.html#_top_">Previous</a>  <a href="java.io.RandomAccessFile.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
<hr>
<h1>
  Class java.io.PushbackReader
</h1>
<pre>
<a href="java.lang.Object.html#_top_">java.lang.Object</a>
   |
   +----<a href="java.io.Reader.html#_top_">java.io.Reader</a>
           |
           +----<a href="java.io.FilterReader.html#_top_">java.io.FilterReader</a>
                   |
                   +----java.io.PushbackReader
</pre>
<hr>
<dl>
  <dt> public class <b>PushbackReader</b>
  <dt> extends <a href="java.io.FilterReader.html#_top_">FilterReader</a>
</dl>
A character-stream reader that allows characters to be pushed back into the
 stream.
<p>
<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="#PushbackReader(java.io.Reader)"><b>PushbackReader</b></a>(Reader)
  <dd>  Create a new pushback reader with a one-character pushback buffer.
  <dt> <img src="images/yellow-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#PushbackReader(java.io.Reader, int)"><b>PushbackReader</b></a>(Reader, int)
  <dd>  Create a new pushback reader with a pushback buffer of the given size.
</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="#markSupported()"><b>markSupported</b></a>()
  <dd>  Tell whether this stream supports the mark() operation, which it does
 not.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#read()"><b>read</b></a>()
  <dd>  Read a single character.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#read(char[], int, int)"><b>read</b></a>(char[], int, int)
  <dd>  Read characters into a portion of an array.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#ready()"><b>ready</b></a>()
  <dd>  Tell whether this stream is ready to be read.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#unread(char[])"><b>unread</b></a>(char[])
  <dd>  Push back an array of characters by copying it to the front of the
 pushback buffer.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#unread(char[], int, int)"><b>unread</b></a>(char[], int, int)
  <dd>  Push back a portion of an array of characters by copying it to the
 front of the pushback buffer.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#unread(int)"><b>unread</b></a>(int)
  <dd>  Push back a single character.
</dl>
<a name="constructors"></a>
<h2>
  <img src="images/constructors.gif" width=231 height=38 alt="Constructors">
</h2>
<a name="PushbackReader"></a>
<a name="PushbackReader(java.io.Reader, int)"><img src="images/yellow-ball.gif" width=12 height=12 alt=" o "></a>
<b>PushbackReader</b>
<pre>
 public PushbackReader(<a href="java.io.Reader.html#_top_">Reader</a> in,
                       int size)
</pre>
<dl>
  <dd> Create a new pushback reader with a pushback buffer of the given size.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> in - The reader from which characters will be read
    <dd> size - The size of the pushback buffer
  </dl></dd>
</dl>
<a name="PushbackReader(java.io.Reader)"><img src="images/yellow-ball.gif" width=12 height=12 alt=" o "></a>
<b>PushbackReader</b>
<pre>
 public PushbackReader(<a href="java.io.Reader.html#_top_">Reader</a> in)
</pre>
<dl>
  <dd> Create a new pushback reader with a one-character pushback buffer.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> in - The reader from which characters will be read
  </dl></dd>
</dl>
<a name="methods"></a>
<h2>
  <img src="images/methods.gif" width=151 height=38 alt="Methods">
</h2>
<a name="read()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="read"><b>read</b></a>
<pre>
 public int read() throws <a href="java.io.IOException.html#_top_">IOException</a>
</pre>
<dl>
  <dd> Read a single character.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> The character read, or -1 if the end of the stream has been
             reached
    <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.FilterReader.html#read()">read</a> in class <a href="java.io.FilterReader.html#_top_">FilterReader</a>
  </dl></dd>
</dl>
<a name="read(char[], int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="read"><b>read</b></a>
<pre>
 public int read(char cbuf[],
                 int off,
                 int len) throws <a href="java.io.IOException.html#_top_">IOException</a>
</pre>
<dl>
  <dd> Read characters into a portion of an array.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> cbuf - Destination buffer
    <dd> off - Offset at which to start writing characters
    <dd> len - Maximum number of characters to read
    <dt> <b>Returns:</b>
    <dd> The number of characters read, or -1 if the end of the
             stream has been reached
    <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.FilterReader.html#read(char[], int, int)">read</a> in class <a href="java.io.FilterReader.html#_top_">FilterReader</a>
  </dl></dd>
</dl>
<a name="unread(int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="unread"><b>unread</b></a>
<pre>
 public void unread(int c) throws <a href="java.io.IOException.html#_top_">IOException</a>
</pre>
<dl>
  <dd> Push back a single character.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> c - The character to push back
    <dt> <b>Throws:</b> <a href="java.io.IOException.html#_top_">IOException</a>
    <dd> If the pushback buffer is full,
                          or if some other I/O error occurs
  </dl></dd>
</dl>
<a name="unread(char[], int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="unread"><b>unread</b></a>
<pre>
 public void unread(char cbuf[],
                    int off,
                    int len) throws <a href="java.io.IOException.html#_top_">IOException</a>
</pre>
<dl>
  <dd> Push back a portion of an array of characters by copying it to the
 front of the pushback buffer.  After this method returns, the next
 character to be read will have the value <code>cbuf[off]</code>, the
 character after that will have the value <code>cbuf[off+1]</code>, and
 so forth.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> cbuf - Character array
    <dd> off - Offset of first character to push back
    <dd> len - Number of characters to push back
    <dt> <b>Throws:</b> <a href="java.io.IOException.html#_top_">IOException</a>
    <dd> If there is insufficient room in the pushback
                          buffer, or if some other I/O error occurs
  </dl></dd>
</dl>
<a name="unread(char[])"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="unread"><b>unread</b></a>
<pre>
 public void unread(char cbuf[]) throws <a href="java.io.IOException.html#_top_">IOException</a>
</pre>
<dl>
  <dd> Push back an array of characters by copying it to the front of the
 pushback buffer.  After this method returns, the next character to be
 read will have the value <code>cbuf[0]</code>, the character after that
 will have the value <code>cbuf[1]</code>, and so forth.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> cbuf - Character array to push back
    <dt> <b>Throws:</b> <a href="java.io.IOException.html#_top_">IOException</a>
    <dd> If there is insufficient room in the pushback
                          buffer, or if some other I/O error occurs
  </dl></dd>
</dl>
<a name="ready()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="ready"><b>ready</b></a>
<pre>
 public boolean ready() throws <a href="java.io.IOException.html#_top_">IOException</a>
</pre>
<dl>
  <dd> Tell whether this stream is ready to be read.
<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.FilterReader.html#ready()">ready</a> in class <a href="java.io.FilterReader.html#_top_">FilterReader</a>
  </dl></dd>
</dl>
<a name="markSupported()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="markSupported"><b>markSupported</b></a>
<pre>
 public boolean markSupported()
</pre>
<dl>
  <dd> Tell whether this stream supports the mark() operation, which it does
 not.
<p>
  <dd><dl>
    <dt> <b>Overrides:</b>
    <dd> <a href="java.io.FilterReader.html#markSupported()">markSupported</a> in class <a href="java.io.FilterReader.html#_top_">FilterReader</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.FilterReader.html#close()">close</a> in class <a href="java.io.FilterReader.html#_top_">FilterReader</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.PushbackInputStream.html#_top_">Previous</a>  <a href="java.io.RandomAccessFile.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>
