@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 line.separator 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{\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 GNU $classpath specific 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 line.separator 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