* c-decl.c (grokdeclarator): In C99 mode, give the more specific

[official-gcc.git] / libjava / doc / java-io.texi

@deftypemethod BufferedInputStream {public synchronized int} available () @*throws IOException

@end deftypemethod
@deftypemethod BufferedInputStream {public void} close () @*throws IOException

@end deftypemethod
@deftypemethod BufferedInputStream {public synchronized void} mark (int@w{ }@var{readlimit}) 

@end deftypemethod
@deftypemethod BufferedInputStream {public boolean} markSupported () 

@end deftypemethod
@deftypemethod BufferedInputStream {public synchronized int} read () @*throws IOException

@end deftypemethod
@deftypemethod BufferedInputStream {public synchronized int} read (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException

@end deftypemethod
@deftypemethod BufferedInputStream {public synchronized void} reset () @*throws IOException

@end deftypemethod
@deftypemethod BufferedInputStream {public synchronized long} skip (long@w{ }@var{n}) @*throws IOException

@end deftypemethod
@deftypemethod BufferedOutputStream {public synchronized void} flush () @*throws IOException
This method causes any currently buffered bytes to be immediately
 written to the underlying output stream.
@end deftypemethod
@deftypemethod BufferedOutputStream {public synchronized void} write (int@w{ }@var{b}) @*throws IOException
This method writes a single byte of data.  This will be written to the
 buffer instead of the underlying data source.  However, if the buffer
 is filled as a result of this write request, it will be flushed to the
 underlying output stream.
@end deftypemethod
@deftypemethod BufferedOutputStream {public synchronized void} write (byte[]@w{ }@var{buf}, int@w{ }@var{offset}, int@w{ }@var{len}) @*throws IOException
This method writes @code{len} bytes from the byte array 
 @code{buf} starting at position @code{offset} in the buffer. 
 These bytes will be written to the internal buffer.  However, if this
 write operation fills the buffer, the buffer will be flushed to the
 underlying output stream.
@end deftypemethod
@deftypemethod BufferedReader {public void} close () @*throws IOException
This method closes the stream
@end deftypemethod
@deftypemethod BufferedReader {public boolean} markSupported () 
Returns @code{true} to indicate that this class supports mark/reset 
 functionality.
@end deftypemethod
@deftypemethod BufferedReader {public void} mark (int@w{ }@var{readLimit}) @*throws IOException
Mark a position in the input to which the stream can be
 "reset" by calling the @code{reset()} method.  The parameter
 @code{readlimit} is the number of chars that can be read from the 
 stream after setting the mark before the mark becomes invalid.  For
 example, if @code{mark()} is called with a read limit of 10, then 
 when 11 chars of data are read from the stream before the 
 @code{reset()} method is called, then the mark is invalid and the 
 stream object instance is not required to remember the mark.
 


 Note that the number of chars that can be remembered by this method
 can be greater than the size of the internal read buffer.  It is also
 not dependent on the subordinate stream supporting mark/reset
 functionality.
@end deftypemethod
@deftypemethod BufferedReader {public void} reset () @*throws IOException
Reset the stream to the point where the @code{mark()} method
 was called.  Any chars that were read after the mark point was set will
 be re-read during subsequent reads.
 


 This method will throw an IOException if the number of chars read from
 the stream since the call to @code{mark()} exceeds the mark limit
 passed when establishing the mark.
@end deftypemethod
@deftypemethod BufferedReader {public boolean} ready () @*throws IOException
This method determines whether or not a stream is ready to be read.  If
 This method returns @code{false} then this stream could (but is
 not guaranteed to) block on the next read attempt.
@end deftypemethod
@deftypemethod BufferedReader {public int} read (char[]@w{ }@var{buf}, int@w{ }@var{offset}, int@w{ }@var{count}) @*throws IOException
This method read chars from a stream and stores them into a caller
 supplied buffer.  It starts storing the data at index @code{offset} into
 the buffer and attempts to read @code{len} chars.  This method can
 return before reading the number of chars requested.  The actual number
 of chars read is returned as an int.  A -1 is returned to indicate the
 end of the stream.
 


 This method will block until some data can be read.
@end deftypemethod
@deftypemethod BufferedReader {public int} read () @*throws IOException

@end deftypemethod
@deftypemethod BufferedReader {public String} readLine () @*throws IOException
This method reads a single line of text from the input stream, returning
 it as a @code{String}.  A line is terminated by "\n", a "\r", or
 an "\r\n" sequence.  The system dependent line separator is not used.
 The line termination characters are not returned in the resulting
 @code{String}.
@end deftypemethod
@deftypemethod BufferedReader {public long} skip (long@w{ }@var{count}) @*throws IOException
This method skips the specified number of chars in the stream.  It
 returns the actual number of chars skipped, which may be less than the
 requested amount.
 


 This method first discards chars in the buffer, then calls the
 @code{skip} method on the underlying stream to skip the remaining chars.
@end deftypemethod
@deftypemethod BufferedWriter {public void} close () @*throws IOException
This method flushes any remaining buffered chars then closes the 
 underlying output stream.  Any further attempts to write to this stream
 may throw an exception
@end deftypemethod
@deftypemethod BufferedWriter {public void} flush () @*throws IOException
This method causes any currently buffered chars to be immediately
 written to the underlying output stream.
@end deftypemethod
@deftypemethod BufferedWriter {public void} newLine () @*throws IOException
This method writes out a system depedent line separator sequence.  The
 actual value written is detemined from the <xmp>line.separator</xmp>
 system property.
@end deftypemethod
@deftypemethod BufferedWriter {public void} write (int@w{ }@var{oneChar}) @*throws IOException
This method writes a single char of data.  This will be written to the
 buffer instead of the underlying data source.  However, if the buffer
 is filled as a result of this write request, it will be flushed to the
 underlying output stream.
@end deftypemethod
@deftypemethod BufferedWriter {public void} write (char[]@w{ }@var{buf}, int@w{ }@var{offset}, int@w{ }@var{len}) @*throws IOException
This method writes @code{len} chars from the char array 
 @code{buf} starting at position @code{offset} in the buffer. 
 These chars will be written to the internal buffer.  However, if this
 write operation fills the buffer, the buffer will be flushed to the
 underlying output stream.
@end deftypemethod
@deftypemethod BufferedWriter {public void} write (java.lang.String@w{ }@var{str}, int@w{ }@var{offset}, int@w{ }@var{len}) @*throws IOException
This method writes @code{len} chars from the @code{String}
 @code{str} starting at position @code{offset} in the string. 
 These chars will be written to the internal buffer.  However, if this
 write operation fills the buffer, the buffer will be flushed to the
 underlying output stream.
@end deftypemethod
@deftypemethod ByteArrayInputStream {public synchronized int} available () 

@end deftypemethod
@deftypemethod ByteArrayInputStream {public synchronized void} mark (int@w{ }@var{readAheadLimit}) 

@end deftypemethod
@deftypemethod ByteArrayInputStream {public boolean} markSupported () 

@end deftypemethod
@deftypemethod ByteArrayInputStream {public synchronized int} read () 

@end deftypemethod
@deftypemethod ByteArrayInputStream {public synchronized int} read (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) 

@end deftypemethod
@deftypemethod ByteArrayInputStream {public synchronized void} reset () 

@end deftypemethod
@deftypemethod ByteArrayInputStream {public synchronized long} skip (long@w{ }@var{n}) 

@end deftypemethod
@deftypemethod ByteArrayOutputStream {public synchronized void} reset () 
This method discards all of the bytes that have been written to
 the internal buffer so far by setting the @code{count}
 variable to 0.  The internal buffer remains at its currently
 allocated size.
@end deftypemethod
@deftypemethod ByteArrayOutputStream {public int} size () 
This method returns the number of bytes that have been written to
 the buffer so far.  This is the same as the value of the protected
 @code{count} variable.  If the @code{reset} method is
 called, then this value is reset as well.  Note that this method does
 not return the length of the internal buffer, but only the number
 of bytes that have been written to it.
@end deftypemethod
@deftypemethod ByteArrayOutputStream {public synchronized byte} toByteArray () 
This method returns a byte array containing the bytes that have been
 written to this stream so far.  This array is a copy of the valid
 bytes in the internal buffer and its length is equal to the number of
 valid bytes, not necessarily to the the length of the current 
 internal buffer.  Note that since this method allocates a new array,
 it should be used with caution when the internal buffer is very large.
@end deftypemethod
@deftypemethod ByteArrayOutputStream {public String} toString () 
Returns the bytes in the internal array as a @code{String}.  The
 bytes in the buffer are converted to characters using the system default
 encoding.  There is an overloaded @code{toString()} method that
 allows an application specified character encoding to be used.
@end deftypemethod
@deftypemethod ByteArrayOutputStream {public String} toString (java.lang.String@w{ }@var{enc}) @*throws UnsupportedEncodingException
Returns the bytes in the internal array as a @code{String}.  The
 bytes in the buffer are converted to characters using the specified
 encoding.
@end deftypemethod
@deftypemethod ByteArrayOutputStream {public String} toString (int@w{ }@var{hibyte}) 
This method returns the bytes in the internal array as a
 @code{String}.  It uses each byte in the array as the low
 order eight bits of the Unicode character value and the passed in
 parameter as the high eight bits.
 


 This method does not convert bytes to characters in the proper way and
 so is deprecated in favor of the other overloaded @code{toString}
 methods which use a true character encoding.
@end deftypemethod
@deftypemethod ByteArrayOutputStream {public synchronized void} write (int@w{ }@var{oneByte}) 
This method writes the writes the specified byte into the internal
 buffer.
@end deftypemethod
@deftypemethod ByteArrayOutputStream {public synchronized void} write (byte[]@w{ }@var{buffer}, int@w{ }@var{offset}, int@w{ }@var{add}) 
This method writes @code{len} bytes from the passed in array 
 @code{buf} starting at index @code{offset} into the
 internal buffer.
@end deftypemethod
@deftypemethod ByteArrayOutputStream {public synchronized void} writeTo (java.io.OutputStream@w{ }@var{out}) @*throws IOException
This method writes all the bytes that have been written to this stream
 from the internal buffer to the specified @code{OutputStream}.
@end deftypemethod
@deftypemethod CharArrayReader {public void} close () 

@end deftypemethod
@deftypemethod CharArrayReader {public void} mark (int@w{ }@var{readAheadLimit}) 

@end deftypemethod
@deftypemethod CharArrayReader {public boolean} markSupported () 

@end deftypemethod
@deftypemethod CharArrayReader {public int} read () @*throws IOException

@end deftypemethod
@deftypemethod CharArrayReader {public int} read (char[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException

@end deftypemethod
@deftypemethod CharArrayReader {public boolean} ready () @*throws IOException

@end deftypemethod
@deftypemethod CharArrayReader {public void} reset () @*throws IOException

@end deftypemethod
@deftypemethod CharArrayReader {public long} skip (long@w{ }@var{n}) @*throws IOException

@end deftypemethod
@deftypemethod CharArrayWriter {public void} close () 

@end deftypemethod
@deftypemethod CharArrayWriter {public void} flush () 

@end deftypemethod
@deftypemethod CharArrayWriter {public synchronized void} reset () 

@end deftypemethod
@deftypemethod CharArrayWriter {public int} size () 

@end deftypemethod
@deftypemethod CharArrayWriter {public char} toCharArray () 

@end deftypemethod
@deftypemethod CharArrayWriter {public String} toString () 

@end deftypemethod
@deftypemethod CharArrayWriter {public void} write (int@w{ }@var{oneChar}) 

@end deftypemethod
@deftypemethod CharArrayWriter {public void} write (char[]@w{ }@var{buffer}, int@w{ }@var{offset}, int@w{ }@var{len}) 

@end deftypemethod
@deftypemethod CharArrayWriter {public void} write (java.lang.String@w{ }@var{str}, int@w{ }@var{offset}, int@w{ }@var{len}) 

@end deftypemethod
@deftypemethod CharArrayWriter {public void} writeTo (java.io.Writer@w{ }@var{out}) @*throws IOException

@end deftypemethod
@deftypemethod DataInput {public boolean} readBoolean () @*throws IOException

@end deftypemethod
@deftypemethod DataInput {public byte} readByte () @*throws IOException

@end deftypemethod
@deftypemethod DataInput {public char} readChar () @*throws IOException

@end deftypemethod
@deftypemethod DataInput {public double} readDouble () @*throws IOException

@end deftypemethod
@deftypemethod DataInput {public float} readFloat () @*throws IOException

@end deftypemethod
@deftypemethod DataInput {public void} readFully (byte[]@w{ }@var{b}) @*throws IOException, NullPointerException

@end deftypemethod
@deftypemethod DataInput {public void} readFully (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException, NullPointerException, IndexOutOfBoundsException

@end deftypemethod
@deftypemethod DataInput {public int} readInt () @*throws IOException

@end deftypemethod
@deftypemethod DataInput {public String} readLine () @*throws IOException

@end deftypemethod
@deftypemethod DataInput {public long} readLong () @*throws IOException

@end deftypemethod
@deftypemethod DataInput {public short} readShort () @*throws IOException

@end deftypemethod
@deftypemethod DataInput {public int} readUnsignedByte () @*throws IOException

@end deftypemethod
@deftypemethod DataInput {public int} readUnsignedShort () @*throws IOException

@end deftypemethod
@deftypemethod DataInput {public String} readUTF () @*throws IOException

@end deftypemethod
@deftypemethod DataInput {public int} skipBytes (int@w{ }@var{n}) @*throws IOException

@end deftypemethod
@deftypemethod DataInputStream {public final int} read (byte[]@w{ }@var{b}) @*throws IOException
This method reads bytes from the underlying stream into the specified
 byte array buffer.  It will attempt to fill the buffer completely, but
 may return a short count if there is insufficient data remaining to be
 read to fill the buffer.
@end deftypemethod
@deftypemethod DataInputStream {public final int} read (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException
This method reads bytes from the underlying stream into the specified
 byte array buffer.  It will attempt to read @code{len} bytes and
 will start storing them at position @code{off} into the buffer.
 This method can return a short count if there is insufficient data
 remaining to be read to complete the desired read length.
@end deftypemethod
@deftypemethod DataInputStream {public final boolean} readBoolean () @*throws IOException
This method reads a Java boolean value from an input stream.  It does
 so by reading a single byte of data.  If that byte is zero, then the
 value returned is @code{false}.  If the byte is non-zero, then
 the value returned is @code{true}.
 


 This method can read a @code{boolean} written by an object
 implementing the @code{writeBoolean()} method in the
 @code{DataOutput} interface.
@end deftypemethod
@deftypemethod DataInputStream {public final byte} readByte () @*throws IOException
This method reads a Java byte value from an input stream.  The value
 is in the range of -128 to 127.
 


 This method can read a @code{byte} written by an object
 implementing the @code{writeByte()} method in the
 @code{DataOutput} interface.
@end deftypemethod
@deftypemethod DataInputStream {public final char} readChar () @*throws IOException
This method reads a Java @code{char} value from an input stream.  
 It operates by reading two bytes from the stream and converting them to 
 a single 16-bit Java @code{char}.  The two bytes are stored most
 significant byte first (i.e., "big endian") regardless of the native
 host byte ordering. 
 


 As an example, if @code{byte1} and @code{byte2}
 represent the first and second byte read from the stream
 respectively, they will be transformed to a @code{char} in
 the following manner: 
 


 @code{(char)(((byte1 & 0xFF) << 8) | (byte2 & 0xFF)}
 


 This method can read a @code{char} written by an object
 implementing the @code{writeChar()} method in the
 @code{DataOutput} interface.
@end deftypemethod
@deftypemethod DataInputStream {public final double} readDouble () @*throws IOException
This method reads a Java double value from an input stream.  It operates
 by first reading a @code{long} value from the stream by calling the
 @code{readLong()} method in this interface, then converts
 that @code{long} to a @code{double} using the
 @code{longBitsToDouble} method in the class
 @code{java.lang.Double} 
 


 This method can read a @code{double} written by an object
 implementing the @code{writeDouble()} method in the
 @code{DataOutput} interface.
@end deftypemethod
@deftypemethod DataInputStream {public final float} readFloat () @*throws IOException
This method reads a Java float value from an input stream.  It
 operates by first reading an @code{int} value from the
 stream by calling the @code{readInt()} method in this
 interface, then converts that @code{int} to a
 @code{float} using the @code{intBitsToFloat} method
 in the class @code{java.lang.Float}
 


 This method can read a @code{float} written by an object
 implementing the * @code{writeFloat()} method in the
 @code{DataOutput} interface.
@end deftypemethod
@deftypemethod DataInputStream {public final void} readFully (byte[]@w{ }@var{b}) @*throws IOException
This method reads raw bytes into the passed array until the array is
 full.  Note that this method blocks until the data is available and
 throws an exception if there is not enough data left in the stream to
 fill the buffer
@end deftypemethod
@deftypemethod DataInputStream {public final void} readFully (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException
This method reads raw bytes into the passed array
 @code{buf} starting @code{offset} bytes into the
 buffer.  The number of bytes read will be exactly
 @code{len} Note that this method blocks until the data is
 available and * throws an exception if there is not enough data
 left in the stream to read @code{len} bytes.
@end deftypemethod
@deftypemethod DataInputStream {public final int} readInt () @*throws IOException
This method reads a Java @code{int} value from an input
 stream It operates by reading four bytes from the stream and
 converting them to a single Java @code{int} The bytes are
 stored most significant byte first (i.e., "big endian")
 regardless of the native host byte ordering.
 


 As an example, if @code{byte1} through @code{byte4}
 represent the first four bytes read from the stream, they will be
 transformed to an @code{int} in the following manner:
 


 @code{(int)(((byte1 & 0xFF) << 24) + ((byte2 & 0xFF) << 16) + 
 ((byte3 & 0xFF) << 8) + (byte4 & 0xFF)))}
 


 The value returned is in the range of 0 to 65535.
 


 This method can read an @code{int} written by an object
 implementing the @code{writeInt()} method in the
 @code{DataOutput} interface.
@end deftypemethod
@deftypemethod DataInputStream {public final String} readLine () @*throws IOException
This method reads the next line of text data from an input
 stream.  It operates by reading bytes and converting those bytes
 to @code{char} values by treating the byte read as the low
 eight bits of the @code{char} and using 0 as the high eight
 bits.  Because of this, it does not support the full 16-bit
 Unicode character set.
 


 The reading of bytes ends when either the end of file or a line
 terminator is encountered.  The bytes read are then returned as a
 @code{String} A line terminator is a byte sequence
 consisting of either @code{\r}, @code{\n} or
 @code{\r\n}.  These termination charaters are discarded and
 are not returned as part of the string.
 


 This method can read data that was written by an object implementing the
 @code{writeLine()} method in @code{DataOutput}.
@end deftypemethod
@deftypemethod DataInputStream {public final long} readLong () @*throws IOException
This method reads a Java long value from an input stream
 It operates by reading eight bytes from the stream and converting them to 
 a single Java @code{long}  The bytes are stored most
 significant byte first (i.e., "big endian") regardless of the native
 host byte ordering. 
 


 As an example, if @code{byte1} through @code{byte8}
 represent the first eight bytes read from the stream, they will
 be transformed to an @code{long} in the following manner:
 


 @code{(long)((((long)byte1 & 0xFF) << 56) + (((long)byte2 & 0xFF) << 48) + 
 (((long)byte3 & 0xFF) << 40) + (((long)byte4 & 0xFF) << 32) + 
 (((long)byte5 & 0xFF) << 24) + (((long)byte6 & 0xFF) << 16) + 
 (((long)byte7 & 0xFF) << 8) + ((long)byte9 & 0xFF)))}
 


 The value returned is in the range of 0 to 65535.
 


 This method can read an @code{long} written by an object
 implementing the @code{writeLong()} method in the
 @code{DataOutput} interface.
@end deftypemethod
@deftypemethod DataInputStream {public final short} readShort () @*throws IOException
This method reads a signed 16-bit value into a Java in from the
 stream.  It operates by reading two bytes from the stream and
 converting them to a single 16-bit Java @code{short}.  The
 two bytes are stored most significant byte first (i.e., "big
 endian") regardless of the native host byte ordering.
 


 As an example, if @code{byte1} and @code{byte2}
 represent the first and second byte read from the stream
 respectively, they will be transformed to a @code{short}. in
 the following manner:
 


 @code{(short)(((byte1 & 0xFF) << 8) | (byte2 & 0xFF)}
 


 The value returned is in the range of -32768 to 32767.
 


 This method can read a @code{short} written by an object
 implementing the @code{writeShort()} method in the
 @code{DataOutput} interface.
@end deftypemethod
@deftypemethod DataInputStream {public final int} readUnsignedByte () @*throws IOException
This method reads 8 unsigned bits into a Java @code{int}
 value from the stream. The value returned is in the range of 0 to
 255.
 


 This method can read an unsigned byte written by an object
 implementing the @code{writeUnsignedByte()} method in the
 @code{DataOutput} interface.
@end deftypemethod
@deftypemethod DataInputStream {public final int} readUnsignedShort () @*throws IOException
This method reads 16 unsigned bits into a Java int value from the stream.
 It operates by reading two bytes from the stream and converting them to 
 a single Java @code{int}  The two bytes are stored most
 significant byte first (i.e., "big endian") regardless of the native
 host byte ordering. 
 


 As an example, if @code{byte1} and @code{byte2}
 represent the first and second byte read from the stream
 respectively, they will be transformed to an @code{int} in
 the following manner:
 


 @code{(int)(((byte1 & 0xFF) << 8) + (byte2 & 0xFF))}
 


 The value returned is in the range of 0 to 65535.
 


 This method can read an unsigned short written by an object
 implementing the @code{writeUnsignedShort()} method in the
 @code{DataOutput} interface.
@end deftypemethod
@deftypemethod DataInputStream {public final String} readUTF () @*throws IOException
This method reads a @code{String} from an input stream that
 is encoded in a modified UTF-8 format.  This format has a leading
 two byte sequence that contains the remaining number of bytes to
 read.  This two byte sequence is read using the
 @code{readUnsignedShort()} method of this interface.
 


 After the number of remaining bytes have been determined, these
 bytes are read an transformed into @code{char} values.
 These @code{char} values are encoded in the stream using
 either a one, two, or three byte format.  The particular format
 in use can be determined by examining the first byte read.
 


 If the first byte has a high order bit of 0, then that character
 consists on only one byte.  This character value consists of
 seven bits that are at positions 0 through 6 of the byte.  As an
 example, if @code{byte1} is the byte read from the stream,
 it would be converted to a @code{char} like so:
 


 @code{(char)byte1}
 


 If the first byte has 110 as its high order bits, then the 
 character consists of two bytes.  The bits that make up the character
 value are in positions 0 through 4 of the first byte and bit positions
 0 through 5 of the second byte.  (The second byte should have 
 10 as its high order bits).  These values are in most significant
 byte first (i.e., "big endian") order.
 


 As an example, if @code{byte1} and @code{byte2} are
 the first two bytes read respectively, and the high order bits of
 them match the patterns which indicate a two byte character
 encoding, then they would be converted to a Java
 @code{char} like so:
 


 @code{(char)(((byte1 & 0x1F) << 6) | (byte2 & 0x3F))}
 


 If the first byte has a 1110 as its high order bits, then the
 character consists of three bytes.  The bits that make up the character
 value are in positions 0 through 3 of the first byte and bit positions
 0 through 5 of the other two bytes.  (The second and third bytes should
 have 10 as their high order bits).  These values are in most
 significant byte first (i.e., "big endian") order.
 


 As an example, if @code{byte1} @code{byte2} and
 @code{byte3} are the three bytes read, and the high order
 bits of them match the patterns which indicate a three byte
 character encoding, then they would be converted to a Java
 @code{char} like so:
 


 @code{(char)(((byte1 & 0x0F) << 12) | ((byte2 & 0x3F) << 6) | (byte3 & 0x3F))}
 


 Note that all characters are encoded in the method that requires
 the fewest number of bytes with the exception of the character
 with the value of @code{&#92;u0000} which is encoded as two
 bytes.  This is a modification of the UTF standard used to
 prevent C language style @code{NUL} values from appearing
 in the byte stream.
 


 This method can read data that was written by an object implementing the
 @code{writeUTF()} method in @code{DataOutput}
@end deftypemethod
@deftypemethod DataInputStream {public static final String} readUTF (java.io.DataInput@w{ }@var{in}) @*throws IOException
This method reads a String encoded in UTF-8 format from the 
 specified @code{DataInput} source.
@end deftypemethod
@deftypemethod DataInputStream {public final int} skipBytes (int@w{ }@var{n}) @*throws IOException
This method attempts to skip and discard the specified number of bytes 
 in the input stream.  It may actually skip fewer bytes than requested. 
 This method will not skip any bytes if passed a negative number of bytes 
 to skip.
@end deftypemethod
@deftypemethod DataOutput {public void} write (int@w{ }@var{b}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutput {public void} write (byte[]@w{ }@var{b}) @*throws IOException, NullPointerException

@end deftypemethod
@deftypemethod DataOutput {public void} write (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException, NullPointerException, IndexOutOfBoundsException

@end deftypemethod
@deftypemethod DataOutput {public void} writeBoolean (boolean@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutput {public void} writeByte (int@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutput {public void} writeShort (int@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutput {public void} writeChar (int@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutput {public void} writeInt (int@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutput {public void} writeLong (long@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutput {public void} writeFloat (float@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutput {public void} writeDouble (double@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutput {public void} writeBytes (java.lang.String@w{ }@var{s}) @*throws IOException, NullPointerException

@end deftypemethod
@deftypemethod DataOutput {public void} writeChars (java.lang.String@w{ }@var{s}) @*throws IOException, NullPointerException

@end deftypemethod
@deftypemethod DataOutput {public void} writeUTF (java.lang.String@w{ }@var{s}) @*throws IOException, NullPointerException

@end deftypemethod
@deftypemethod DataOutputStream {public void} flush () @*throws IOException

@end deftypemethod
@deftypemethod DataOutputStream {public final int} size () 

@end deftypemethod
@deftypemethod DataOutputStream {public synchronized void} write (int@w{ }@var{b}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutputStream {public synchronized void} write (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException, NullPointerException, IndexOutOfBoundsException

@end deftypemethod
@deftypemethod DataOutputStream {public final void} writeBoolean (boolean@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutputStream {public final void} writeByte (int@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutputStream {public final void} writeShort (int@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutputStream {public final void} writeChar (int@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutputStream {public final void} writeInt (int@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutputStream {public final void} writeLong (long@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutputStream {public final void} writeFloat (float@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutputStream {public final void} writeDouble (double@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutputStream {public final void} writeBytes (java.lang.String@w{ }@var{s}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutputStream {public final void} writeChars (java.lang.String@w{ }@var{s}) @*throws IOException

@end deftypemethod
@deftypemethod DataOutputStream {public final void} writeUTF (java.lang.String@w{ }@var{s}) @*throws IOException

@end deftypemethod
@deftypemethod Externalizable {public void} readExternal (java.io.ObjectInput@w{ }@var{in}) @*throws ClassNotFoundException, IOException
This method restores an object's state by reading in the instance data
 for the object from the passed in stream.  Note that this stream is not
 a subclass of @code{InputStream}, but rather is a class that implements
 the @code{ObjectInput} interface.  That interface provides a mechanism for
 reading in Java data types from a stream.
 


 Note that this method must be compatible with @code{writeExternal}.
 It must read back the exact same types that were written by that
 method in the exact order they were written.
 


 If this method needs to read back an object instance, then the class
 for that object must be found and loaded.  If that operation fails,
 then this method throws a @code{ClassNotFoundException}
@end deftypemethod
@deftypemethod Externalizable {public void} writeExternal (java.io.ObjectOutput@w{ }@var{out}) @*throws IOException
This method is responsible for writing the instance data of an object
 to the passed in stream.  Note that this stream is not a subclass of
 @code{OutputStream}, but rather is a class that implements the
 @code{ObjectOutput} interface.  That interface provides a number of methods
 for writing Java data values to a stream.
 


 Not that the implementation of this method must be coordinated with
 the implementation of @code{readExternal}.
@end deftypemethod
@deftypemethod FileDescriptor {public native void} sync () @*throws SyncFailedException

@end deftypemethod
@deftypemethod FileDescriptor {public native boolean} valid () 

@end deftypemethod
@deftypemethod FileDescriptor {protected void} finalize () @*throws IOException

@end deftypemethod
@deftypemethod FileFilter {public boolean} accept (java.io.File@w{ }@var{pathname}) 
This method determines whether or not a given pathname should be included
 in a pathname listing.
@end deftypemethod
@deftypemethod FileInputStream {public int} available () @*throws IOException

@end deftypemethod
@deftypemethod FileInputStream {public void} close () @*throws IOException

@end deftypemethod
@deftypemethod FileInputStream {protected void} finalize () @*throws IOException

@end deftypemethod
@deftypemethod FileInputStream {public final FileDescriptor} getFD () @*throws IOException

@end deftypemethod
@deftypemethod FileInputStream {public int} read () @*throws IOException

@end deftypemethod
@deftypemethod FileInputStream {public int} read (byte[]@w{ }@var{b}) @*throws IOException

@end deftypemethod
@deftypemethod FileInputStream {public int} read (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException

@end deftypemethod
@deftypemethod FileInputStream {public long} skip (long@w{ }@var{n}) @*throws IOException

@end deftypemethod
@deftypemethod File {public boolean} canRead () 

@end deftypemethod
@deftypemethod File {public boolean} canWrite () 

@end deftypemethod
@deftypemethod File {public boolean} delete () 

@end deftypemethod
@deftypemethod File {public boolean} equals (java.lang.Object@w{ }@var{obj}) 

@end deftypemethod
@deftypemethod File {public boolean} exists () 

@end deftypemethod
@deftypemethod File {public String} getAbsolutePath () 

@end deftypemethod
@deftypemethod File {public native String} getCanonicalPath () @*throws IOException

@end deftypemethod
@deftypemethod File {public String} getName () 

@end deftypemethod
@deftypemethod File {public String} getParent () 

@end deftypemethod
@deftypemethod File {public File} getParentFile () 

@end deftypemethod
@deftypemethod File {public String} getPath () 

@end deftypemethod
@deftypemethod File {public int} hashCode () 

@end deftypemethod
@deftypemethod File {public native boolean} isAbsolute () 

@end deftypemethod
@deftypemethod File {public boolean} isDirectory () 

@end deftypemethod
@deftypemethod File {public boolean} isFile () 

@end deftypemethod
@deftypemethod File {public long} lastModified () 

@end deftypemethod
@deftypemethod File {public long} length () 

@end deftypemethod
@deftypemethod File {public String} list (java.io.FilenameFilter@w{ }@var{filter}) 

@end deftypemethod
@deftypemethod File {public String} list () 

@end deftypemethod
@deftypemethod File {public String} toString () 

@end deftypemethod
@deftypemethod File {public boolean} mkdir () 

@end deftypemethod
@deftypemethod File {public boolean} mkdirs () 

@end deftypemethod
@deftypemethod File {public static File} createTempFile (java.lang.String@w{ }@var{prefix}, java.lang.String@w{ }@var{suffix}, java.io.File@w{ }@var{directory}) @*throws IOException

@end deftypemethod
@deftypemethod File {public static File} createTempFile (java.lang.String@w{ }@var{prefix}, java.lang.String@w{ }@var{suffix}) @*throws IOException

@end deftypemethod
@deftypemethod File {public boolean} renameTo (java.io.File@w{ }@var{dest}) 

@end deftypemethod
@deftypemethod File {public void} deleteOnExit () 

@end deftypemethod
@deftypemethod FilenameFilter {public boolean} accept (java.io.File@w{ }@var{dir}, java.lang.String@w{ }@var{name}) 

@end deftypemethod
@deftypemethod FileOutputStream {protected void} finalize () @*throws IOException

@end deftypemethod
@deftypemethod FileOutputStream {public final FileDescriptor} getFD () @*throws IOException

@end deftypemethod
@deftypemethod FileOutputStream {public void} write (int@w{ }@var{b}) @*throws IOException

@end deftypemethod
@deftypemethod FileOutputStream {public void} write (byte[]@w{ }@var{b}) @*throws IOException, NullPointerException

@end deftypemethod
@deftypemethod FileOutputStream {public void} write (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException, NullPointerException, IndexOutOfBoundsException

@end deftypemethod
@deftypemethod FileOutputStream {public void} close () @*throws IOException

@end deftypemethod
@deftypemethod FilePermission {public String} getActions () 
Get the actions this FilePermission supports.
@end deftypemethod
@deftypemethod FilePermission {public int} hashCode () 
Get the hash code for this Object.


 FilePermission's hash code is calculated as the exclusive or of the target
 String's hash code and the action String's hash code.
@end deftypemethod
@deftypemethod FilePermission {public boolean} equals (java.lang.Object@w{ }@var{o}) 
Check two FilePermissions for semantic equality.
 Two FilePermissions are exactly equivalent if they have identical path
 expressions and have exactly the same access permissions.
@end deftypemethod
@deftypemethod FilePermission {public boolean} implies (java.security.Permission@w{ }@var{p}) 
Check to see if this permission implies another.
 Permission A implies permission B if these things are all true:
 
@itemize @bullet

 
@item
A and B are both FilePermissions.

 
@item
All possible files in B are included in A (possibly more are in A).

 
@item
All actions B supports, A also supports.

 
@end itemize

@end deftypemethod
@deftypemethod FilterInputStream {public int} available () @*throws IOException

@end deftypemethod
@deftypemethod FilterInputStream {public void} close () @*throws IOException

@end deftypemethod
@deftypemethod FilterInputStream {public synchronized void} mark (int@w{ }@var{readlimit}) 

@end deftypemethod
@deftypemethod FilterInputStream {public boolean} markSupported () 

@end deftypemethod
@deftypemethod FilterInputStream {public int} read () @*throws IOException

@end deftypemethod
@deftypemethod FilterInputStream {public int} read (byte[]@w{ }@var{b}) @*throws IOException

@end deftypemethod
@deftypemethod FilterInputStream {public int} read (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException

@end deftypemethod
@deftypemethod FilterInputStream {public synchronized void} reset () @*throws IOException

@end deftypemethod
@deftypemethod FilterInputStream {public long} skip (long@w{ }@var{n}) @*throws IOException

@end deftypemethod
@deftypemethod FilterOutputStream {public void} close () @*throws IOException

@end deftypemethod
@deftypemethod FilterOutputStream {public void} flush () @*throws IOException

@end deftypemethod
@deftypemethod FilterOutputStream {public void} write (int@w{ }@var{b}) @*throws IOException

@end deftypemethod
@deftypemethod FilterOutputStream {public void} write (byte[]@w{ }@var{b}) @*throws IOException, NullPointerException

@end deftypemethod
@deftypemethod FilterOutputStream {public void} write (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException, NullPointerException, IndexOutOfBoundsException

@end deftypemethod
@deftypemethod FilterReader {public void} close () @*throws IOException

@end deftypemethod
@deftypemethod FilterReader {public synchronized void} mark (int@w{ }@var{readlimit}) @*throws IOException

@end deftypemethod
@deftypemethod FilterReader {public boolean} markSupported () 

@end deftypemethod
@deftypemethod FilterReader {public int} read () @*throws IOException

@end deftypemethod
@deftypemethod FilterReader {public int} read (char[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException

@end deftypemethod
@deftypemethod FilterReader {public boolean} ready () @*throws IOException

@end deftypemethod
@deftypemethod FilterReader {public synchronized void} reset () @*throws IOException

@end deftypemethod
@deftypemethod FilterReader {public long} skip (long@w{ }@var{n}) @*throws IOException

@end deftypemethod
@deftypemethod FilterWriter {public void} close () @*throws IOException

@end deftypemethod
@deftypemethod FilterWriter {public void} flush () @*throws IOException

@end deftypemethod
@deftypemethod FilterWriter {public void} write (int@w{ }@var{oneChar}) @*throws IOException

@end deftypemethod
@deftypemethod FilterWriter {public void} write (char[]@w{ }@var{buffer}, int@w{ }@var{offset}, int@w{ }@var{count}) @*throws IOException

@end deftypemethod
@deftypemethod FilterWriter {public void} write (java.lang.String@w{ }@var{str}, int@w{ }@var{offset}, int@w{ }@var{count}) @*throws IOException

@end deftypemethod
@deftypemethod InputStream {public int} available () @*throws IOException

@end deftypemethod
@deftypemethod InputStream {public void} close () @*throws IOException

@end deftypemethod
@deftypemethod InputStream {public void} mark (int@w{ }@var{readlimit}) 

@end deftypemethod
@deftypemethod InputStream {public boolean} markSupported () 

@end deftypemethod
@deftypemethod InputStream {public abstract int} read () @*throws IOException

@end deftypemethod
@deftypemethod InputStream {public int} read (byte[]@w{ }@var{b}) @*throws IOException

@end deftypemethod
@deftypemethod InputStream {public int} read (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException

@end deftypemethod
@deftypemethod InputStream {public void} reset () @*throws IOException

@end deftypemethod
@deftypemethod InputStream {public long} skip (long@w{ }@var{n}) @*throws IOException

@end deftypemethod
@deftypemethod InputStreamReader {public void} close () @*throws IOException

@end deftypemethod
@deftypemethod InputStreamReader {public String} getEncoding () 

@end deftypemethod
@deftypemethod InputStreamReader {public boolean} ready () @*throws IOException

@end deftypemethod
@deftypemethod InputStreamReader {public int} read (char[]@w{ }@var{buf}, int@w{ }@var{offset}, int@w{ }@var{length}) @*throws IOException

@end deftypemethod
@deftypemethod InputStreamReader {public int} read () @*throws IOException

@end deftypemethod
@deftypemethod InvalidClassException {public String} getMessage () 
Returns the descriptive error message for this exception.  It will
 include the class name that caused the problem if known.  This method
 overrides Throwable.getMessage()
@end deftypemethod
@deftypemethod LineNumberInputStream {public int} available () @*throws IOException

@end deftypemethod
@deftypemethod LineNumberInputStream {public int} getLineNumber () 

@end deftypemethod
@deftypemethod LineNumberInputStream {public void} mark (int@w{ }@var{readlimit}) 

@end deftypemethod
@deftypemethod LineNumberInputStream {public int} read () @*throws IOException

@end deftypemethod
@deftypemethod LineNumberInputStream {public int} read (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException

@end deftypemethod
@deftypemethod LineNumberInputStream {public void} reset () @*throws IOException

@end deftypemethod
@deftypemethod LineNumberInputStream {public void} setLineNumber (int@w{ }@var{lineNumber}) 

@end deftypemethod
@deftypemethod LineNumberInputStream {public long} skip (long@w{ }@var{n}) @*throws IOException

@end deftypemethod
@deftypemethod LineNumberReader {public int} getLineNumber () 

@end deftypemethod
@deftypemethod LineNumberReader {public void} setLineNumber (int@w{ }@var{lineNumber}) 

@end deftypemethod
@deftypemethod LineNumberReader {public void} mark (int@w{ }@var{readLimit}) @*throws IOException

@end deftypemethod
@deftypemethod LineNumberReader {public void} reset () @*throws IOException

@end deftypemethod
@deftypemethod LineNumberReader {public int} read () @*throws IOException

@end deftypemethod
@deftypemethod LineNumberReader {public int} read (char[]@w{ }@var{buf}, int@w{ }@var{offset}, int@w{ }@var{count}) @*throws IOException

@end deftypemethod
@deftypemethod LineNumberReader {public String} readLine () @*throws IOException

@end deftypemethod
@deftypemethod LineNumberReader {public long} skip (long@w{ }@var{count}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectInput {public int} available () @*throws IOException
This method returns the number of bytes that can be read without
 blocking.
@end deftypemethod
@deftypemethod ObjectInput {public int} read () @*throws IOException
This method reading a byte of data from a stream.  It returns that byte
 as an int.  This method blocks if no data is available to be read.
@end deftypemethod
@deftypemethod ObjectInput {public int} read (byte[]@w{ }@var{buf}) @*throws IOException
This method reads raw bytes and stores them them a byte array buffer.
 Note that this method will block if no data is available.  However, 
 it will not necessarily block until it fills the entire buffer.  That is,
 a "short count" is possible.
@end deftypemethod
@deftypemethod ObjectInput {public int} read (byte[]@w{ }@var{buf}, int@w{ }@var{offset}, int@w{ }@var{len}) @*throws IOException
This method reads raw bytes and stores them in a byte array buffer
 @code{buf} starting at position @code{offset} into the buffer.  A 
 maximum of @code{len} bytes will be read.  Note that this method
 blocks if no data is available, but will not necessarily block until
 it can read @code{len} bytes of data.  That is, a "short count" is
 possible.
@end deftypemethod
@deftypemethod ObjectInput {public Object} readObject () @*throws ClassNotFoundException, IOException
Reads an object instance and returns it.  If the class for the object
 being read cannot be found, then a ClassNotFoundException will
 be thrown.
@end deftypemethod
@deftypemethod ObjectInput {public long} skip (long@w{ }@var{num_bytes}) @*throws IOException
This method causes the specified number of bytes to be read and
 discarded.  It is possible that fewer than the requested number of bytes
 will actually be skipped.
@end deftypemethod
@deftypemethod ObjectInput {public void} close () @*throws IOException
This method closes the input source
@end deftypemethod
@deftypemethod ObjectInputStream {public final Object} readObject () @*throws ClassNotFoundException, IOException
Returns the next deserialized object read from the underlying stream.

This method can be overriden by a class by implementing
@code{private void readObject (ObjectInputStream)}.

If an exception is thrown from this method, the stream is left in
an undefined state.
@end deftypemethod
@deftypemethod ObjectInputStream {public void} defaultReadObject () @*throws ClassNotFoundException, IOException, NotActiveException
Reads the current objects non-transient, non-static fields from
the current class from the underlying output stream.

This method is intended to be called from within a object's
@code{private void readObject (ObjectInputStream)}
method.
@end deftypemethod
@deftypemethod ObjectInputStream {public void} registerValidation (java.io.ObjectInputValidation@w{ }@var{validator}, int@w{ }@var{priority}) @*throws InvalidObjectException, NotActiveException
Registers a @code{ObjectInputValidation} to be carried out
on the object graph currently being deserialized before it is
returned to the original caller of @code{readObject ()}.
The order of validation for multiple
@code{ObjectInputValidation}s can be controled using
@code{priority}.  Validators with higher priorities are
called first.
@end deftypemethod
@deftypemethod ObjectInputStream {protected Class} resolveClass (java.io.ObjectStreamClass@w{ }@var{osc}) @*throws ClassNotFoundException, IOException
Called when a class is being deserialized.  This is a hook to
allow subclasses to read in information written by the
@code{annotateClass (Class)} method of an
@code{ObjectOutputStream}.

This implementation looks up the active call stack for a
@code{ClassLoader}; if a @code{ClassLoader} is found,
it is used to load the class associated with @code{osc},
otherwise, the default system @code{ClassLoader} is used.
@end deftypemethod
@deftypemethod ObjectInputStream {protected Object} resolveObject (java.lang.Object@w{ }@var{obj}) @*throws IOException
Allows subclasses to resolve objects that are read from the
stream with other objects to be returned in their place.  This
method is called the first time each object is encountered.

This method must be enabled before it will be called in the
serialization process.
@end deftypemethod
@deftypemethod ObjectInputStream {protected boolean} enableResolveObject (boolean@w{ }@var{enable}) @*throws SecurityException
If @code{enable} is @code{true} and this object is
trusted, then @code{resolveObject (Object)} will be called
in subsequent calls to @code{readObject (Object)}.
Otherwise, @code{resolveObject (Object)} will not be called.
@end deftypemethod
@deftypemethod ObjectInputStream {protected void} readStreamHeader () @*throws IOException, StreamCorruptedException
Reads stream magic and stream version information from the
underlying stream.
@end deftypemethod
@deftypemethod ObjectInputStream {public int} read () @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public int} read (byte[]@w{ }@var{data}, int@w{ }@var{offset}, int@w{ }@var{length}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public int} available () @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public void} close () @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public boolean} readBoolean () @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public byte} readByte () @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public int} readUnsignedByte () @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public short} readShort () @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public int} readUnsignedShort () @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public char} readChar () @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public int} readInt () @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public long} readLong () @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public float} readFloat () @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public double} readDouble () @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public void} readFully (byte[]@w{ }@var{data}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public void} readFully (byte[]@w{ }@var{data}, int@w{ }@var{offset}, int@w{ }@var{size}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public int} skipBytes (int@w{ }@var{len}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public String} readLine () @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public String} readUTF () @*throws IOException

@end deftypemethod
@deftypemethod ObjectInputStream {public ObjectInputStream.GetField} readFields () @*throws IOException, ClassNotFoundException, NotActiveException

@end deftypemethod
@deftypemethod ObjectInputStream {protected Object} readObjectOverride () @*throws ClassNotFoundException, IOException, OptionalDataException
This method allows subclasses to override the default
de serialization mechanism provided by
@code{ObjectInputStream}.  To make this method be used for
writing objects, subclasses must invoke the 0-argument
constructor on this class from there constructor.
@end deftypemethod
@deftypemethod ObjectInputStream.GetField {public abstract ObjectStreamClass} getObjectStreamClass () 

@end deftypemethod
@deftypemethod ObjectInputStream.GetField {public abstract boolean} defaulted (java.lang.String@w{ }@var{name}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectInputStream.GetField {public abstract boolean} get (java.lang.String@w{ }@var{name}, boolean@w{ }@var{defvalue}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectInputStream.GetField {public abstract char} get (java.lang.String@w{ }@var{name}, char@w{ }@var{defvalue}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectInputStream.GetField {public abstract byte} get (java.lang.String@w{ }@var{name}, byte@w{ }@var{defvalue}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectInputStream.GetField {public abstract short} get (java.lang.String@w{ }@var{name}, short@w{ }@var{defvalue}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectInputStream.GetField {public abstract int} get (java.lang.String@w{ }@var{name}, int@w{ }@var{defvalue}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectInputStream.GetField {public abstract long} get (java.lang.String@w{ }@var{name}, long@w{ }@var{defvalue}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectInputStream.GetField {public abstract float} get (java.lang.String@w{ }@var{name}, float@w{ }@var{defvalue}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectInputStream.GetField {public abstract double} get (java.lang.String@w{ }@var{name}, double@w{ }@var{defvalue}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectInputStream.GetField {public abstract Object} get (java.lang.String@w{ }@var{name}, java.lang.Object@w{ }@var{defvalue}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectInputValidation {public void} validateObject () @*throws InvalidObjectException
This method is called to validate an object.  If the object is invalid
 an exception is thrown.
@end deftypemethod
@deftypemethod ObjectOutput {public void} write (int@w{ }@var{b}) @*throws IOException
This method writes the specified byte to the output stream.
@end deftypemethod
@deftypemethod ObjectOutput {public void} write (byte[]@w{ }@var{buf}) @*throws IOException
This method writes all the bytes in the specified byte array to the
 output stream.
@end deftypemethod
@deftypemethod ObjectOutput {public void} write (byte[]@w{ }@var{buf}, int@w{ }@var{offset}, int@w{ }@var{len}) @*throws IOException
This method writes @code{len} bytes from the specified array
 starting at index @code{offset} into that array.
@end deftypemethod
@deftypemethod ObjectOutput {public void} writeObject (java.lang.Object@w{ }@var{obj}) @*throws IOException
This method writes a object instance to a stream.  The format of the
 data written is determined by the actual implementation of this method
@end deftypemethod
@deftypemethod ObjectOutput {public void} flush () @*throws IOException
This method causes any buffered data to be flushed out to the underlying
 stream
@end deftypemethod
@deftypemethod ObjectOutput {public void} close () @*throws IOException
This method closes the underlying stream.
@end deftypemethod
@deftypemethod ObjectOutputStream {public final void} writeObject (java.lang.Object@w{ }@var{obj}) @*throws IOException
Writes a representation of @code{obj} to the underlying
output stream by writing out information about its class, then
writing out each of the objects non-transient, non-static
fields.  If any of these fields are other objects,
they are written out in the same manner.

This method can be overriden by a class by implementing
@code{private void writeObject (ObjectOutputStream)}.

If an exception is thrown from this method, the stream is left in
an undefined state.
@end deftypemethod
@deftypemethod ObjectOutputStream {public void} defaultWriteObject () @*throws IOException, NotActiveException
Writes the current objects non-transient, non-static fields from
the current class to the underlying output stream.

This method is intended to be called from within a object's
@code{private void writeObject (ObjectOutputStream)}
method.
@end deftypemethod
@deftypemethod ObjectOutputStream {public void} reset () @*throws IOException
Resets stream to state equivalent to the state just after it was
constructed.

Causes all objects previously written to the stream to be
forgotten.  A notification of this reset is also written to the
underlying stream.
@end deftypemethod
@deftypemethod ObjectOutputStream {public void} useProtocolVersion (int@w{ }@var{version}) @*throws IOException
Informs this @code{ObjectOutputStream} to write data
according to the specified protocol.  There are currently two
different protocols, specified by @code{PROTOCOL_VERSION_1}
and @code{PROTOCOL_VERSION_2}.  This implementation writes
data using @code{PROTOCOL_VERSION_1} by default, as is done
by the JDK 1.1.

A non-portable method, @code{setDefaultProtocolVersion (int
version)} is provided to change the default protocol
version.

For an explination of the differences beween the two protocols
see XXX: the Java ObjectSerialization Specification.
@end deftypemethod
@deftypemethod ObjectOutputStream {public static void} setDefaultProtocolVersion (int@w{ }@var{version}) @*throws IOException
<em>GNU $classpath specific</em>

Changes the default stream protocol used by all
@code{ObjectOutputStream}s.  There are currently two
different protocols, specified by @code{PROTOCOL_VERSION_1}
and @code{PROTOCOL_VERSION_2}.  The default default is
@code{PROTOCOL_VERSION_1}.
@end deftypemethod
@deftypemethod ObjectOutputStream {protected void} annotateClass (java.lang.Class@w{ }@var{cl}) @*throws IOException
An empty hook that allows subclasses to write extra information
about classes to the stream.  This method is called the first
time each class is seen, and after all of the standard
information about the class has been written.
@end deftypemethod
@deftypemethod ObjectOutputStream {protected Object} replaceObject (java.lang.Object@w{ }@var{obj}) @*throws IOException
Allows subclasses to replace objects that are written to the
stream with other objects to be written in their place.  This
method is called the first time each object is encountered
(modulo reseting of the stream).

This method must be enabled before it will be called in the
serialization process.
@end deftypemethod
@deftypemethod ObjectOutputStream {protected boolean} enableReplaceObject (boolean@w{ }@var{enable}) @*throws SecurityException
If @code{enable} is @code{true} and this object is
trusted, then @code{replaceObject (Object)} will be called
in subsequent calls to @code{writeObject (Object)}.
Otherwise, @code{replaceObject (Object)} will not be called.
@end deftypemethod
@deftypemethod ObjectOutputStream {protected void} writeStreamHeader () @*throws IOException
Writes stream magic and stream version information to the
underlying stream.
@end deftypemethod
@deftypemethod ObjectOutputStream {protected void} writeObjectOverride (java.lang.Object@w{ }@var{obj}) @*throws NotActiveException, IOException
This method allows subclasses to override the default
serialization mechanism provided by
@code{ObjectOutputStream}.  To make this method be used for
writing objects, subclasses must invoke the 0-argument
constructor on this class from there constructor.
@end deftypemethod
@deftypemethod ObjectOutputStream {public void} write (int@w{ }@var{data}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream {public void} write (byte[]@w{ }@var{b}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream {public void} write (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream {public void} flush () @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream {protected void} drain () @*throws IOException
Causes the block-data buffer to be written to the underlying
stream, but does not flush underlying stream.
@end deftypemethod
@deftypemethod ObjectOutputStream {public void} close () @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream {public void} writeBoolean (boolean@w{ }@var{data}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream {public void} writeByte (int@w{ }@var{data}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream {public void} writeShort (int@w{ }@var{data}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream {public void} writeChar (int@w{ }@var{data}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream {public void} writeInt (int@w{ }@var{data}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream {public void} writeLong (long@w{ }@var{data}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream {public void} writeFloat (float@w{ }@var{data}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream {public void} writeDouble (double@w{ }@var{data}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream {public void} writeBytes (java.lang.String@w{ }@var{data}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream {public void} writeChars (java.lang.String@w{ }@var{data}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream {public void} writeUTF (java.lang.String@w{ }@var{data}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream {public ObjectOutputStream.PutField} putFields () @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream {public void} writeFields () @*throws IOException

@end deftypemethod
@deftypemethod ObjectOutputStream.PutField {public abstract void} put (java.lang.String@w{ }@var{name}, boolean@w{ }@var{value}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectOutputStream.PutField {public abstract void} put (java.lang.String@w{ }@var{name}, byte@w{ }@var{value}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectOutputStream.PutField {public abstract void} put (java.lang.String@w{ }@var{name}, char@w{ }@var{value}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectOutputStream.PutField {public abstract void} put (java.lang.String@w{ }@var{name}, double@w{ }@var{value}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectOutputStream.PutField {public abstract void} put (java.lang.String@w{ }@var{name}, float@w{ }@var{value}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectOutputStream.PutField {public abstract void} put (java.lang.String@w{ }@var{name}, int@w{ }@var{value}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectOutputStream.PutField {public abstract void} put (java.lang.String@w{ }@var{name}, long@w{ }@var{value}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectOutputStream.PutField {public abstract void} put (java.lang.String@w{ }@var{name}, short@w{ }@var{value}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectOutputStream.PutField {public abstract void} put (java.lang.String@w{ }@var{name}, java.lang.Object@w{ }@var{value}) @*throws IOException, IllegalArgumentException

@end deftypemethod
@deftypemethod ObjectOutputStream.PutField {public abstract void} write (java.io.ObjectOutput@w{ }@var{out}) @*throws IOException

@end deftypemethod
@deftypemethod ObjectStreamClass {public static ObjectStreamClass} lookup (java.lang.Class@w{ }@var{cl}) 
Returns the @code{ObjectStreamClass} for @code{cl}.
If @code{cl} is null, or is not @code{Serializable},
null is returned.  @code{ObjectStreamClass}'s are memorized;
later calls to this method with the same class will return the
same @code{ObjectStreamClass} object and no recalculation
will be done.
@end deftypemethod
@deftypemethod ObjectStreamClass {public String} getName () 
Returns the name of the class that this
@code{ObjectStreamClass} represents.
@end deftypemethod
@deftypemethod ObjectStreamClass {public Class} forClass () 
Returns the class that this @code{ObjectStreamClass}
represents.  Null could be returned if this
@code{ObjectStreamClass} was read from an
@code{ObjectInputStream} and the class it represents cannot
be found or loaded.
@end deftypemethod
@deftypemethod ObjectStreamClass {public long} getSerialVersionUID () 
Returns the serial version stream-unique identifier for the class
represented by this @code{ObjectStreamClass}.  This SUID is
either defined by the class as @code{static final long
serialVersionUID} or is calculated as specified in
Javasoft's "Object Serialization Specification" XXX: add reference
@end deftypemethod
@deftypemethod ObjectStreamClass {public ObjectStreamField} getFields () 

@end deftypemethod
@deftypemethod ObjectStreamClass {public ObjectStreamField} getField (java.lang.String@w{ }@var{name}) 

@end deftypemethod
@deftypemethod ObjectStreamClass {public String} toString () 
Returns a textual representation of this
@code{ObjectStreamClass} object including the name of the
class it represents as well as that class's serial version
stream-unique identifier.
@end deftypemethod
@deftypemethod ObjectStreamField {public String} getName () 

@end deftypemethod
@deftypemethod ObjectStreamField {public Class} getType () 

@end deftypemethod
@deftypemethod ObjectStreamField {public char} getTypeCode () 

@end deftypemethod
@deftypemethod ObjectStreamField {public String} getTypeString () 

@end deftypemethod
@deftypemethod ObjectStreamField {public int} getOffset () 

@end deftypemethod
@deftypemethod ObjectStreamField {protected void} setOffset (int@w{ }@var{off}) 

@end deftypemethod
@deftypemethod ObjectStreamField {public boolean} isPrimitive () 

@end deftypemethod
@deftypemethod ObjectStreamField {public int} compareTo (java.lang.Object@w{ }@var{o}) 

@end deftypemethod
@deftypemethod ObjectStreamField {public String} toString () 

@end deftypemethod
@deftypemethod OutputStream {public abstract void} write (int@w{ }@var{b}) @*throws IOException

@end deftypemethod
@deftypemethod OutputStream {public void} write (byte[]@w{ }@var{b}) @*throws IOException, NullPointerException

@end deftypemethod
@deftypemethod OutputStream {public void} write (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException, NullPointerException, IndexOutOfBoundsException

@end deftypemethod
@deftypemethod OutputStream {public void} flush () @*throws IOException

@end deftypemethod
@deftypemethod OutputStream {public void} close () @*throws IOException

@end deftypemethod
@deftypemethod OutputStreamWriter {public String} getEncoding () 

@end deftypemethod
@deftypemethod OutputStreamWriter {public void} close () @*throws IOException

@end deftypemethod
@deftypemethod OutputStreamWriter {public void} flush () @*throws IOException

@end deftypemethod
@deftypemethod OutputStreamWriter {public void} write (char[]@w{ }@var{buf}, int@w{ }@var{offset}, int@w{ }@var{count}) @*throws IOException

@end deftypemethod
@deftypemethod OutputStreamWriter {public void} write (java.lang.String@w{ }@var{str}, int@w{ }@var{offset}, int@w{ }@var{count}) @*throws IOException

@end deftypemethod
@deftypemethod OutputStreamWriter {public void} write (int@w{ }@var{ch}) @*throws IOException

@end deftypemethod
@deftypemethod PipedInputStream {public void} connect (java.io.PipedOutputStream@w{ }@var{source}) @*throws IOException
This method connects this stream to the passed in @code{PipedOutputStream}.
 This stream is then ready for reading.  If this stream is already
 connected or has been previously closed, then an exception is thrown
@end deftypemethod
@deftypemethod PipedInputStream {protected synchronized void} receive (int@w{ }@var{b}) @*throws IOException
This method receives a byte of input from the source PipedOutputStream.
 If the internal circular buffer is full, this method blocks.
@end deftypemethod
@deftypemethod PipedInputStream {public int} read () @*throws IOException
This method reads bytes from the stream into a caller supplied buffer.
 It starts storing bytes at position @code{offset} into the buffer and
 reads a maximum of @code{len} bytes.  Note that this method can actually
 read fewer than @code{len} bytes.  The actual number of bytes read is
 returned.  A -1 is returned to indicated that no bytes can be read
 because the end of the stream was reached.  If the stream is already
 closed, a -1 will again be returned to indicate the end of the stream.
 


 This method will block if no bytes are available to be read.
@end deftypemethod
@deftypemethod PipedInputStream {public synchronized int} read (byte[]@w{ }@var{buf}, int@w{ }@var{offset}, int@w{ }@var{len}) @*throws IOException
This method reads bytes from the stream into a caller supplied buffer.
 It starts storing bytes at position @code{offset} into the buffer and
 reads a maximum of @code{len} bytes.  Note that this method can actually
 read fewer than @code{len} bytes.  The actual number of bytes read is
 returned.  A -1 is returned to indicated that no bytes can be read
 because the end of the stream was reached - ie close() was called on the
 connected PipedOutputStream.
 


 This method will block if no bytes are available to be read.
@end deftypemethod
@deftypemethod PipedInputStream {public synchronized int} available () @*throws IOException
This method returns the number of bytes that can be read from this stream
 before blocking could occur.  This is the number of bytes that are
 currently unread in the internal circular buffer.  Note that once this
 many additional bytes are read, the stream may block on a subsequent
 read, but it not guaranteed to block.
@end deftypemethod
@deftypemethod PipedInputStream {public synchronized void} close () @*throws IOException
This methods closes the stream so that no more data can be read
 from it.
@end deftypemethod
@deftypemethod PipedOutputStream {public void} connect (java.io.PipedInputStream@w{ }@var{sink}) @*throws IOException
Connects this object to the specified @code{PipedInputStream} 
 object.  This stream will then be ready for writing.
@end deftypemethod
@deftypemethod PipedOutputStream {public void} write (int@w{ }@var{b}) @*throws IOException
Write a single byte of date to the stream.  Note that this method will 
 block if the @code{PipedInputStream} to which this object is 
 connected has a full buffer.
@end deftypemethod
@deftypemethod PipedOutputStream {public void} write (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException
This method writes @code{len} bytes of data from the byte array
 @code{buf} starting at index @code{offset} in the array
 to the stream.  Note that this method will block if the  
 @code{PipedInputStream} to which this object is connected has
 a buffer that cannot hold all of the bytes to be written.
@end deftypemethod
@deftypemethod PipedOutputStream {public void} flush () 
This method does nothing.
@end deftypemethod
@deftypemethod PipedOutputStream {public void} close () 
This method closes this stream so that no more data can be written
 to it. Any further attempts to write to this stream may throw an
 exception
@end deftypemethod
@deftypemethod PipedReader {public void} connect (java.io.PipedWriter@w{ }@var{source}) @*throws IOException
This method connects this stream to the passed in @code{PipedWriter}.
 This stream is then ready for reading.  If this stream is already
 connected or has been previously closed, then an exception is thrown
@end deftypemethod
@deftypemethod PipedReader {public int} read () @*throws IOException
This method reads chars from the stream into a caller supplied buffer.
 It starts storing chars at position @code{offset} into the buffer and
 reads a maximum of @code{len} chars.  Note that this method can actually
 read fewer than @code{len} chars.  The actual number of chars read is
 returned.  A -1 is returned to indicated that no chars can be read
 because the end of the stream was reached.  If the stream is already
 closed, a -1 will again be returned to indicate the end of the stream.
 


 This method will block if no chars are available to be read.
@end deftypemethod
@deftypemethod PipedReader {public int} read (char[]@w{ }@var{buf}, int@w{ }@var{offset}, int@w{ }@var{len}) @*throws IOException
This method reads characters from the stream into a caller supplied buffer.
 It starts storing chars at position @code{offset} into the buffer and
 reads a maximum of @code{len} chars.  Note that this method can actually
 read fewer than @code{len} chars.  The actual number of chars read is
 returned.  A -1 is returned to indicated that no chars can be read
 because the end of the stream was reached - ie close() was called on the
 connected PipedWriter.
 


 This method will block if no chars are available to be read.
@end deftypemethod
@deftypemethod PipedReader {public boolean} ready () @*throws IOException

@end deftypemethod
@deftypemethod PipedReader {public void} close () @*throws IOException
This methods closes the stream so that no more data can be read
 from it.
@end deftypemethod
@deftypemethod PipedWriter {public void} connect (java.io.PipedReader@w{ }@var{sink}) @*throws IOException
Connects this object to the specified @code{PipedReader} 
 object.  This stream will then be ready for writing.
@end deftypemethod
@deftypemethod PipedWriter {public void} write (char@w{ }@var{b}) @*throws IOException
Write a single char of date to the stream.  Note that this method will 
 block if the @code{PipedReader} to which this object is 
 connected has a full buffer.
@end deftypemethod
@deftypemethod PipedWriter {public void} write (char[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException
This method writes @code{len} chars of data from the char array
 @code{buf} starting at index @code{offset} in the array
 to the stream.  Note that this method will block if the  
 @code{PipedReader} to which this object is connected has
 a buffer that cannot hold all of the chars to be written.
@end deftypemethod
@deftypemethod PipedWriter {public void} flush () 
This method does nothing.
@end deftypemethod
@deftypemethod PipedWriter {public void} close () 
This method closes this stream so that no more data can be written
 to it. Any further attempts to write to this stream may throw an
 exception
@end deftypemethod
@deftypemethod PrintStream {public boolean} checkError () 

@end deftypemethod
@deftypemethod PrintStream {public void} close () 

@end deftypemethod
@deftypemethod PrintStream {public void} flush () 

@end deftypemethod
@deftypemethod PrintStream {public void} print (boolean@w{ }@var{bool}) 

@end deftypemethod
@deftypemethod PrintStream {public void} print (int@w{ }@var{inum}) 

@end deftypemethod
@deftypemethod PrintStream {public void} print (long@w{ }@var{lnum}) 

@end deftypemethod
@deftypemethod PrintStream {public void} print (float@w{ }@var{fnum}) 

@end deftypemethod
@deftypemethod PrintStream {public void} print (double@w{ }@var{dnum}) 

@end deftypemethod
@deftypemethod PrintStream {public void} print (java.lang.Object@w{ }@var{obj}) 

@end deftypemethod
@deftypemethod PrintStream {public void} print (java.lang.String@w{ }@var{str}) 

@end deftypemethod
@deftypemethod PrintStream {public synchronized void} print (char@w{ }@var{ch}) 

@end deftypemethod
@deftypemethod PrintStream {public void} print (char[]@w{ }@var{charArray}) 

@end deftypemethod
@deftypemethod PrintStream {public void} println () 

@end deftypemethod
@deftypemethod PrintStream {public void} println (boolean@w{ }@var{bool}) 

@end deftypemethod
@deftypemethod PrintStream {public void} println (int@w{ }@var{inum}) 

@end deftypemethod
@deftypemethod PrintStream {public void} println (long@w{ }@var{lnum}) 

@end deftypemethod
@deftypemethod PrintStream {public void} println (float@w{ }@var{fnum}) 

@end deftypemethod
@deftypemethod PrintStream {public void} println (double@w{ }@var{dnum}) 

@end deftypemethod
@deftypemethod PrintStream {public void} println (java.lang.Object@w{ }@var{obj}) 

@end deftypemethod
@deftypemethod PrintStream {public void} println (java.lang.String@w{ }@var{str}) 

@end deftypemethod
@deftypemethod PrintStream {public synchronized void} println (char@w{ }@var{ch}) 

@end deftypemethod
@deftypemethod PrintStream {public void} println (char[]@w{ }@var{charArray}) 

@end deftypemethod
@deftypemethod PrintStream {protected void} setError () 

@end deftypemethod
@deftypemethod PrintStream {public void} write (int@w{ }@var{oneByte}) 

@end deftypemethod
@deftypemethod PrintStream {public void} write (byte[]@w{ }@var{buffer}, int@w{ }@var{offset}, int@w{ }@var{count}) 

@end deftypemethod
@deftypemethod PrintWriter {protected void} setError () 
This method can be called by subclasses to indicate that an error
 has occurred and should be reported by @code{checkError}.
@end deftypemethod
@deftypemethod PrintWriter {public boolean} checkError () 
This method checks to see if an error has occurred on this stream.  Note
 that once an error has occurred, this method will continue to report
 @code{true} forever for this stream.  Before checking for an
 error condition, this method flushes the stream.
@end deftypemethod
@deftypemethod PrintWriter {public void} flush () 
This method flushes any buffered chars to the underlying stream and
 then flushes that stream as well.
@end deftypemethod
@deftypemethod PrintWriter {public void} close () 
This method closes this stream and all underlying streams.
@end deftypemethod
@deftypemethod PrintWriter {public void} print (java.lang.String@w{ }@var{str}) 
This method prints a @code{String} to the stream.  The actual
 value printed depends on the system default encoding.
@end deftypemethod
@deftypemethod PrintWriter {public void} print (char@w{ }@var{ch}) 
This method prints a char to the stream.  The actual value printed is
 determined by the character encoding in use.
@end deftypemethod
@deftypemethod PrintWriter {public void} print (char[]@w{ }@var{charArray}) 
This method prints an array of characters to the stream.  The actual
 value printed depends on the system default encoding.
@end deftypemethod
@deftypemethod PrintWriter {public void} print (boolean@w{ }@var{bool}) 
This methods prints a boolean value to the stream.  @code{true}
 values are printed as "true" and @code{false} values are printed
 as "false".
@end deftypemethod
@deftypemethod PrintWriter {public void} print (int@w{ }@var{inum}) 
This method prints an integer to the stream.  The value printed is
 determined using the @code{String.valueOf()} method.
@end deftypemethod
@deftypemethod PrintWriter {public void} print (long@w{ }@var{lnum}) 
This method prints a long to the stream.  The value printed is
 determined using the @code{String.valueOf()} method.
@end deftypemethod
@deftypemethod PrintWriter {public void} print (float@w{ }@var{fnum}) 
This method prints a float to the stream.  The value printed is
 determined using the @code{String.valueOf()} method.
@end deftypemethod
@deftypemethod PrintWriter {public void} print (double@w{ }@var{dnum}) 
This method prints a double to the stream.  The value printed is
 determined using the @code{String.valueOf()} method.
@end deftypemethod
@deftypemethod PrintWriter {public void} print (java.lang.Object@w{ }@var{obj}) 
This method prints an @code{Object} to the stream.  The actual
 value printed is determined by calling the @code{String.valueOf()}
 method.
@end deftypemethod
@deftypemethod PrintWriter {public void} println () 
This method prints a line separator sequence to the stream.  The value
 printed is determined by the system property <xmp>line.separator</xmp>
 and is not necessarily the Unix '\n' newline character.
@end deftypemethod
@deftypemethod PrintWriter {public void} println (boolean@w{ }@var{bool}) 
This methods prints a boolean value to the stream.  @code{true}
 values are printed as "true" and @code{false} values are printed
 as "false".

 This method prints a line termination sequence after printing the value.
@end deftypemethod
@deftypemethod PrintWriter {public void} println (int@w{ }@var{inum}) 
This method prints an integer to the stream.  The value printed is
 determined using the @code{String.valueOf()} method.

 This method prints a line termination sequence after printing the value.
@end deftypemethod
@deftypemethod PrintWriter {public void} println (long@w{ }@var{lnum}) 
This method prints a long to the stream.  The value printed is
 determined using the @code{String.valueOf()} method.

 This method prints a line termination sequence after printing the value.
@end deftypemethod
@deftypemethod PrintWriter {public void} println (float@w{ }@var{fnum}) 
This method prints a float to the stream.  The value printed is
 determined using the @code{String.valueOf()} method.

 This method prints a line termination sequence after printing the value.
@end deftypemethod
@deftypemethod PrintWriter {public void} println (double@w{ }@var{dnum}) 
This method prints a double to the stream.  The value printed is
 determined using the @code{String.valueOf()} method.

 This method prints a line termination sequence after printing the value.
@end deftypemethod
@deftypemethod PrintWriter {public void} println (java.lang.Object@w{ }@var{obj}) 
This method prints an @code{Object} to the stream.  The actual
 value printed is determined by calling the @code{String.valueOf()}
 method.

 This method prints a line termination sequence after printing the value.
@end deftypemethod
@deftypemethod PrintWriter {public void} println (java.lang.String@w{ }@var{str}) 
This method prints a @code{String} to the stream.  The actual
 value printed depends on the system default encoding.

 This method prints a line termination sequence after printing the value.
@end deftypemethod
@deftypemethod PrintWriter {public void} println (char@w{ }@var{ch}) 
This method prints a char to the stream.  The actual value printed is
 determined by the character encoding in use.

 This method prints a line termination sequence after printing the value.
@end deftypemethod
@deftypemethod PrintWriter {public void} println (char[]@w{ }@var{charArray}) 
This method prints an array of characters to the stream.  The actual
 value printed depends on the system default encoding.

 This method prints a line termination sequence after printing the value.
@end deftypemethod
@deftypemethod PrintWriter {public void} write (int@w{ }@var{ch}) 
This method writes a single char to the stream.
@end deftypemethod
@deftypemethod PrintWriter {public void} write (char[]@w{ }@var{charArray}, int@w{ }@var{offset}, int@w{ }@var{count}) 
This method writes @code{count} chars from the specified array 
 starting at index @code{offset} into the array.
@end deftypemethod
@deftypemethod PrintWriter {public void} write (java.lang.String@w{ }@var{str}, int@w{ }@var{offset}, int@w{ }@var{count}) 
This method writes @code{count} chars from the specified
 @code{String} to the output starting at character position
 @code{offset} into the @code{String}
@end deftypemethod
@deftypemethod PrintWriter {public void} write (char[]@w{ }@var{charArray}) 
This method write all the chars in the specified array to the output.
@end deftypemethod
@deftypemethod PrintWriter {public void} write (java.lang.String@w{ }@var{str}) 
This method writes the contents of the specified @code{String}
 to the underlying stream.
@end deftypemethod
@deftypemethod PushbackInputStream {public int} available () @*throws IOException

@end deftypemethod
@deftypemethod PushbackInputStream {public void} close () @*throws IOException

@end deftypemethod
@deftypemethod PushbackInputStream {public boolean} markSupported () 

@end deftypemethod
@deftypemethod PushbackInputStream {public int} read () @*throws IOException

@end deftypemethod
@deftypemethod PushbackInputStream {public int} read (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException

@end deftypemethod
@deftypemethod PushbackInputStream {public void} unread (int@w{ }@var{b}) @*throws IOException

@end deftypemethod
@deftypemethod PushbackInputStream {public void} unread (byte[]@w{ }@var{b}) @*throws IOException

@end deftypemethod
@deftypemethod PushbackInputStream {public void} unread (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException

@end deftypemethod
@deftypemethod PushbackInputStream {public long} skip (long@w{ }@var{n}) @*throws IOException

@end deftypemethod
@deftypemethod PushbackReader {public void} close () @*throws IOException
This method closes the stream and frees any associated resources.
@end deftypemethod
@deftypemethod PushbackReader {public void} mark (int@w{ }@var{read_limit}) @*throws IOException
This method throws an exception when called since this class does
 not support mark/reset.
@end deftypemethod
@deftypemethod PushbackReader {public boolean} markSupported () 
This method returns @code{false} to indicate that it does not support
 mark/reset functionality.
@end deftypemethod
@deftypemethod PushbackReader {public void} reset () @*throws IOException
This method always throws an IOException in this class because
 mark/reset functionality is not supported.
@end deftypemethod
@deftypemethod PushbackReader {public boolean} ready () @*throws IOException
This method determines whether or not this stream is ready to be read.
 If it returns @code{false} to indicate that the stream is not
 ready, any attempt to read from the stream could (but is not
 guaranteed to) block.
 


 This stream is ready to read if there are either chars waiting to be
 read in the pushback buffer or if the underlying stream is ready to
 be read.
@end deftypemethod
@deftypemethod PushbackReader {public long} skip (long@w{ }@var{num_chars}) @*throws IOException
This method skips the specified number of chars in the stream.  It
 returns the actual number of chars skipped, which may be less than the
 requested amount.
 


 This method first discards chars from the buffer, then calls the
 @code{skip} method on the underlying @code{Reader} to 
 skip additional chars if necessary.
@end deftypemethod
@deftypemethod PushbackReader {public int} read () @*throws IOException
This method reads an unsigned char from the input stream and returns it
 as an int in the range of 0-65535.  This method also will return -1 if
 the end of the stream has been reached.  The char returned will be read
 from the pushback buffer, unless the buffer is empty, in which case
 the char will be read from the underlying stream.
 


 This method will block until the char can be read.
@end deftypemethod
@deftypemethod PushbackReader {public synchronized int} read (char[]@w{ }@var{b}, int@w{ }@var{offset}, int@w{ }@var{len}) @*throws IOException
This method read chars from a stream and stores them into a caller
 supplied buffer.  It starts storing the data at index @code{offset} into
 the buffer and attempts to read @code{len} chars.  This method can
 return before reading the number of chars requested.  The actual number
 of chars read is returned as an int.  A -1 is returned to indicate the
 end of the stream.
  


 This method will block until some data can be read.
 


 This method first reads chars from the pushback buffer in order to 
 satisfy the read request.  If the pushback buffer cannot provide all
 of the chars requested, the remaining chars are read from the 
 underlying stream.
@end deftypemethod
@deftypemethod PushbackReader {public void} unread (int@w{ }@var{b}) @*throws IOException
This method pushes a single char of data into the pushback buffer.
 The char pushed back is the one that will be returned as the first char
 of the next read.
 


 If the pushback buffer is full, this method throws an exception.
 


 The argument to this method is an @code{int}.  Only the low eight bits
 of this value are pushed back.
@end deftypemethod
@deftypemethod PushbackReader {public synchronized void} unread (char[]@w{ }@var{buf}) @*throws IOException
This method pushes all of the chars in the passed char array into 
 the pushback buffer.  These chars are pushed in reverse order so that
 the next char read from the stream after this operation will be
 @code{buf[0]} followed by @code{buf[1]}, etc.
 


 If the pushback buffer cannot hold all of the requested chars, an
 exception is thrown.
@end deftypemethod
@deftypemethod PushbackReader {public synchronized void} unread (char[]@w{ }@var{b}, int@w{ }@var{offset}, int@w{ }@var{len}) @*throws IOException
This method pushed back chars from the passed in array into the pushback
 buffer.  The chars from @code{buf[offset]} to @code{buf[offset + len]}
 are pushed in reverse order so that the next char read from the stream
 after this operation will be @code{buf[offset]} followed by
 @code{buf[offset + 1]}, etc.
 


 If the pushback buffer cannot hold all of the requested chars, an
 exception is thrown.
@end deftypemethod
@deftypemethod RandomAccessFile {public void} close () @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final FileDescriptor} getFD () @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public long} getFilePointer () @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public long} length () @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public int} read () @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public int} read (byte[]@w{ }@var{buffer}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public int} read (byte[]@w{ }@var{buffer}, int@w{ }@var{offset}, int@w{ }@var{count}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final boolean} readBoolean () @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final byte} readByte () @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final char} readChar () @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final double} readDouble () @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final float} readFloat () @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final void} readFully (byte[]@w{ }@var{buffer}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final void} readFully (byte[]@w{ }@var{buffer}, int@w{ }@var{offset}, int@w{ }@var{count}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final int} readInt () @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final String} readLine () @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final long} readLong () @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final short} readShort () @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final int} readUnsignedByte () @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final int} readUnsignedShort () @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final String} readUTF () @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public void} seek (long@w{ }@var{pos}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public int} skipBytes (int@w{ }@var{count}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public void} write (int@w{ }@var{oneByte}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public void} write (byte[]@w{ }@var{buffer}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public void} write (byte[]@w{ }@var{buffer}, int@w{ }@var{offset}, int@w{ }@var{count}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final void} writeBoolean (boolean@w{ }@var{val}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final void} writeByte (int@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final void} writeShort (int@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final void} writeChar (int@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final void} writeInt (int@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final void} writeLong (long@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final void} writeFloat (float@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final void} writeDouble (double@w{ }@var{v}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final void} writeBytes (java.lang.String@w{ }@var{s}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final void} writeChars (java.lang.String@w{ }@var{s}) @*throws IOException

@end deftypemethod
@deftypemethod RandomAccessFile {public final void} writeUTF (java.lang.String@w{ }@var{s}) @*throws IOException

@end deftypemethod
@deftypemethod Reader {public abstract int} read (char[]@w{ }@var{buf}, int@w{ }@var{offset}, int@w{ }@var{count}) @*throws IOException
Read chars from a stream and stores them into a caller
 supplied buffer.  It starts storing the data at index @code{offset} 
 into the buffer and attempts to read @code{len} chars.  This method 
 can return before reading the number of chars requested.  The actual 
 number of chars read is returned as an int.  A -1 is returned to indicate 
 the end of the stream.
 


 This method will block until some data can be read.
 


 This method operates by calling the single char @code{read()} method
 in a loop until the desired number of chars are read.  The read loop
 stops short if the end of the stream is encountered or if an IOException
 is encountered on any read operation except the first.  If the first
 attempt to read a chars fails, the IOException is allowed to propagate
 upward.  And subsequent IOException is caught and treated identically
 to an end of stream condition.  Subclasses can (and should if possible)
 override this method to provide a more efficient implementation.
@end deftypemethod
@deftypemethod Reader {public int} read (char[]@w{ }@var{buf}) @*throws IOException
Reads chars from a stream and stores them into a caller
 supplied buffer.  This method attempts to completely fill the buffer,
 but can return before doing so.  The actual number of chars read is
 returned as an int.  A -1 is returned to indicate the end of the stream.
 


 This method will block until some data can be read.
 


 This method operates by calling an overloaded read method like so:
 @code{read(buf, 0, buf.length)}
@end deftypemethod
@deftypemethod Reader {public int} read () @*throws IOException
Reads an char from the input stream and returns it
 as an int in the range of 0-65535.  This method also will return -1 if
 the end of the stream has been reached.
 


 This method will block until the char can be read.
@end deftypemethod
@deftypemethod Reader {public abstract void} close () @*throws IOException
Closes the stream.  Any futher attempts to read from the
 stream may generate an @code{IOException}.
@end deftypemethod
@deftypemethod Reader {public boolean} markSupported () 
Returns a boolean that indicates whether the mark/reset
 methods are supported in this class.  Those methods can be used to
 remember a specific point in the stream and reset the stream to that
 point.
 


 This method always returns @code{false} in this class, but
 subclasses can override this method to return @code{true} if they 
 support mark/reset functionality.
@end deftypemethod
@deftypemethod Reader {public void} mark (int@w{ }@var{readLimit}) @*throws IOException
Marks a position in the input to which the stream can be
 "reset" by calling the @code{reset()} method.  The parameter
 @code{readlimit} is the number of chars that can be read from the 
 stream after setting the mark before the mark becomes invalid.  For
 example, if @code{mark()} is called with a read limit of 10, then 
 when 11 chars of data are read from the stream before the 
 @code{reset()} method is called, then the mark is invalid and the 
 stream object instance is not required to remember the mark.
@end deftypemethod
@deftypemethod Reader {public void} reset () @*throws IOException
Resets a stream to the point where the @code{mark()} 
 method was called.  Any chars that were read after the mark point was 
 set will be re-read during subsequent reads.
 


 This method always throws an IOException in this class, but subclasses
 can override this method if they provide mark/reset functionality.
@end deftypemethod
@deftypemethod Reader {public boolean} ready () @*throws IOException
Determines whether or not this stream is ready to be
 read.  If it returns @code{false} the stream may block if a
 read is attempted, but it is not guaranteed to do so.
 


 This method always returns @code{false} in this class
@end deftypemethod
@deftypemethod Reader {public long} skip (long@w{ }@var{count}) @*throws IOException
Skips the specified number of chars in the stream.  It
 returns the actual number of chars skipped, which may be less than the
 requested amount.
 


 This method reads and discards chars into a 256 char array until the
 specified number of chars were skipped or until either the end of stream
 is reached or a read attempt returns a short count.  Subclasses can
 override this method to provide a more efficient implementation where
 one exists.
@end deftypemethod
@deftypemethod SequenceInputStream {public int} available () @*throws IOException

@end deftypemethod
@deftypemethod SequenceInputStream {public void} close () @*throws IOException

@end deftypemethod
@deftypemethod SequenceInputStream {public int} read () @*throws IOException

@end deftypemethod
@deftypemethod SequenceInputStream {public int} read (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException

@end deftypemethod
@deftypemethod StreamTokenizer {public void} commentChar (int@w{ }@var{ch}) 
This method sets the comment attribute on the specified character.
@end deftypemethod
@deftypemethod StreamTokenizer {public void} eolIsSignificant (boolean@w{ }@var{flag}) 
This method sets a flag that indicates whether or not the end of line
 sequence terminates and is a token.  The defaults to @code{false}
@end deftypemethod
@deftypemethod StreamTokenizer {public int} lineno () 
This method returns the current line number.  Note that if the 
 @code{pushBack()} method is called, it has no effect on the
 line number returned by this method.
@end deftypemethod
@deftypemethod StreamTokenizer {public void} lowerCaseMode (boolean@w{ }@var{flag}) 
This method sets a flag that indicates whether or not alphabetic
 tokens that are returned should be converted to lower case.
@end deftypemethod
@deftypemethod StreamTokenizer {public int} nextToken () @*throws IOException
This method reads the next token from the stream.  It sets the 
 @code{ttype} variable to the appropriate token type and 
 returns it.  It also can set @code{sval} or @code{nval}
 as described below.  The parsing strategy is as follows:
 
@itemize @bullet

 
@item
Skip any whitespace characters.
 
@item
If a numeric character is encountered, attempt to parse a numeric
 value.  Leading '-' characters indicate a numeric only if followed by
 another non-'-' numeric.  The value of the numeric token is terminated
 by either the first non-numeric encountered, or the second occurrence of
 '-' or '.'.  The token type returned is TT_NUMBER and @code{nval}
 is set to the value parsed.
 
@item
If an alphabetic character is parsed, all subsequent characters
 are read until the first non-alphabetic or non-numeric character is
 encountered.  The token type returned is TT_WORD and the value parsed
 is stored in @code{sval}.  If lower case mode is set, the token
 stored in @code{sval} is converted to lower case.  The end of line
 sequence terminates a word only if EOL signficance has been turned on.
 The start of a comment also terminates a word.  Any character with a 
 non-alphabetic and non-numeric attribute (such as white space, a quote,
 or a commet) are treated as non-alphabetic and terminate the word.
 
@item
If a comment charcters is parsed, then all remaining characters on
 the current line are skipped and another token is parsed.  Any EOL or
 EOF's encountered are not discarded, but rather terminate the comment.
 
@item
If a quote character is parsed, then all characters up to the 
 second occurrence of the same quote character are parsed into a
 @code{String}.  This @code{String} is stored as
 @code{sval}, but is not converted to lower case, even if lower case
 mode is enabled.  The token type returned is the value of the quote
 character encountered.  Any escape sequences
 (\b (backspace), \t (HTAB), \n (linefeed), \f (form feed), \r
 (carriage return), \" (double quote), \' (single quote), \\
 (backslash), \XXX (octal esacpe)) are converted to the appropriate
 char values.  Invalid esacape sequences are left in untranslated.  
 Unicode characters like ('\ u0000') are not recognized. 
 
@item
If the C++ comment sequence "//" is encountered, and the parser
 is configured to handle that sequence, then the remainder of the line
 is skipped and another token is read exactly as if a character with
 the comment attribute was encountered.
 
@item
If the C comment sequence "/*" is encountered, and the parser
 is configured to handle that sequence, then all characters up to and
 including the comment terminator sequence are discarded and another
 token is parsed.
 
@item
If all cases above are not met, then the character is an ordinary
 character that is parsed as a token by itself.  The char encountered
 is returned as the token type.
 
@end itemize

@end deftypemethod
@deftypemethod StreamTokenizer {public void} ordinaryChar (int@w{ }@var{ch}) 
This method makes the specified character an ordinary character.  This
 means that none of the attributes (whitespace, alphabetic, numeric,
 quote, or comment) will be set on this character.  This character will
 parse as its own token.
@end deftypemethod
@deftypemethod StreamTokenizer {public void} ordinaryChars (int@w{ }@var{low}, int@w{ }@var{hi}) 
This method makes all the characters in the specified range, range
 terminators included, ordinary.  This means the none of the attributes
 (whitespace, alphabetic, numeric, quote, or comment) will be set on
 any of the characters in the range.  This makes each character in this
 range parse as its own token.
@end deftypemethod
@deftypemethod StreamTokenizer {public void} parseNumbers () 
This method sets the numeric attribute on the characters '0' - '9' and
 the characters '.' and '-'.
@end deftypemethod
@deftypemethod StreamTokenizer {public void} pushBack () 
This method returns the current line number.  Note that if the 
 @code{pushBack()} method is called, it has no effect on the
 line number returned by this method.
@end deftypemethod
@deftypemethod StreamTokenizer {public void} quoteChar (int@w{ }@var{ch}) 
This method sets the quote attribute on the specified character.
@end deftypemethod
@deftypemethod StreamTokenizer {public void} resetSyntax () 
This method removes all attributes (whitespace, alphabetic, numeric,
 quote, and comment) from all characters.  It is equivalent to calling
 @code{ordinaryChars(0x00, 0xFF)}.
@end deftypemethod
@deftypemethod StreamTokenizer {public void} slashSlashComments (boolean@w{ }@var{flag}) 
This method sets a flag that indicates whether or not "C++" language style
 comments ("//" comments through EOL ) are handled by the parser.
 If this is @code{true} commented out sequences are skipped and
 ignored by the parser.  This defaults to @code{false}.
@end deftypemethod
@deftypemethod StreamTokenizer {public void} slashStarComments (boolean@w{ }@var{flag}) 
This method sets a flag that indicates whether or not "C" language style
 comments (with nesting not allowed) are handled by the parser.
 If this is @code{true} commented out sequences are skipped and
 ignored by the parser.  This defaults to @code{false}.
@end deftypemethod
@deftypemethod StreamTokenizer {public String} toString () 
This method returns the current token value as a @code{String} in
 the form "Token[x], line n", where 'n' is the current line numbers and
 'x' is determined as follows.
 


 
@itemize @bullet

 
@item
If no token has been read, then 'x' is "NOTHING" and 'n' is 0
 
@item
If @code{ttype} is TT_EOF, then 'x' is "EOF"
 
@item
If @code{ttype} is TT_EOL, then 'x' is "EOL"
 
@item
If @code{ttype} is TT_WORD, then 'x' is @code{sval}
 
@item
If @code{ttype} is TT_NUMBER, then 'x' is "n=strnval" where
 'strnval' is @code{String.valueOf(nval)}.
 
@item
If @code{ttype} is a quote character, then 'x' is
 @code{sval}
 
@item
For all other cases, 'x' is @code{ttype}
 
@end itemize

@end deftypemethod
@deftypemethod StreamTokenizer {public void} whitespaceChars (int@w{ }@var{low}, int@w{ }@var{hi}) 
This method sets the whitespace attribute for all charcters in the
 specified range, range terminators included.
@end deftypemethod
@deftypemethod StreamTokenizer {public void} wordChars (int@w{ }@var{low}, int@w{ }@var{hi}) 
This method sets the alphabetic attribute for all charcters in the
 specified range, range terminators included.
@end deftypemethod
@deftypemethod StringBufferInputStream {public int} available () 

@end deftypemethod
@deftypemethod StringBufferInputStream {public int} read () 

@end deftypemethod
@deftypemethod StringBufferInputStream {public int} read (byte[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) 

@end deftypemethod
@deftypemethod StringBufferInputStream {public void} reset () 

@end deftypemethod
@deftypemethod StringBufferInputStream {public long} skip (long@w{ }@var{n}) 

@end deftypemethod
@deftypemethod StringReader {public void} close () 

@end deftypemethod
@deftypemethod StringReader {public void} mark (int@w{ }@var{readAheadLimit}) @*throws IOException

@end deftypemethod
@deftypemethod StringReader {public boolean} markSupported () 

@end deftypemethod
@deftypemethod StringReader {public int} read () @*throws IOException

@end deftypemethod
@deftypemethod StringReader {public int} read (char[]@w{ }@var{b}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException

@end deftypemethod
@deftypemethod StringReader {public boolean} ready () @*throws IOException
This method determines if the stream is ready to be read.  This class
 is always ready to read and so always returns @code{true}, unless
 close() has previously been called in which case an IOException is
 thrown.
@end deftypemethod
@deftypemethod StringReader {public void} reset () @*throws IOException
Sets the read position in the stream to the previously
 marked position or to 0 (i.e., the beginning of the stream) if the mark
 has not already been set.
@end deftypemethod
@deftypemethod StringReader {public long} skip (long@w{ }@var{n}) @*throws IOException
This method attempts to skip the requested number of chars in the
 input stream.  It does this by advancing the @code{pos} value by 
 the specified number of chars.  It this would exceed the length of the
 buffer, then only enough chars are skipped to position the stream at
 the end of the buffer.  The actual number of chars skipped is returned.
@end deftypemethod
@deftypemethod StringWriter {public void} close () 

@end deftypemethod
@deftypemethod StringWriter {public void} flush () 

@end deftypemethod
@deftypemethod StringWriter {public StringBuffer} getBuffer () 

@end deftypemethod
@deftypemethod StringWriter {public String} toString () 

@end deftypemethod
@deftypemethod StringWriter {public void} write (int@w{ }@var{oneChar}) 

@end deftypemethod
@deftypemethod StringWriter {public void} write (char[]@w{ }@var{chars}, int@w{ }@var{offset}, int@w{ }@var{len}) 

@end deftypemethod
@deftypemethod StringWriter {public void} write (java.lang.String@w{ }@var{str}) 

@end deftypemethod
@deftypemethod StringWriter {public void} write (java.lang.String@w{ }@var{str}, int@w{ }@var{offset}, int@w{ }@var{len}) 

@end deftypemethod
@deftypemethod WriteAbortedException {public String} getMessage () 
This method returns a message indicating what went wrong, including 
 the message text from the initial exception that caused this one to
 be thrown
@end deftypemethod
@deftypemethod Writer {public abstract void} close () @*throws IOException

@end deftypemethod
@deftypemethod Writer {public abstract void} flush () @*throws IOException

@end deftypemethod
@deftypemethod Writer {public abstract void} write (char[]@w{ }@var{buf}, int@w{ }@var{offset}, int@w{ }@var{count}) @*throws IOException

@end deftypemethod
@deftypemethod Writer {public void} write (char[]@w{ }@var{buf}) @*throws IOException

@end deftypemethod
@deftypemethod Writer {public void} write (int@w{ }@var{ch}) @*throws IOException

@end deftypemethod
@deftypemethod Writer {public void} write (java.lang.String@w{ }@var{str}, int@w{ }@var{offset}, int@w{ }@var{count}) @*throws IOException

@end deftypemethod
@deftypemethod Writer {public void} write (java.lang.String@w{ }@var{str}) @*throws IOException

@end deftypemethod