All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class sdsu.io.UnicodeReader

java.lang.Object
   |
   +----java.io.Reader
           |
           +----java.io.FilterReader
                   |
                   +----sdsu.io.UnicodeReader

public class UnicodeReader
extends FilterReader
This class provides a way of getting interpreted Unicode input from a reader. ASCII is a subset of Unicode. ASCII characters are read correctly. The standard Java library doesn't provide any way of reading things like integers from standard input. This functionality is nice to have for interactive programs.

Version:
0.9 14 Sept 1997
Author:
Andrew Scherpbier (andrew@sdsu.edu), Roger Whitney (whitney@cs.sdsu.edu)

Constructor Index

 o UnicodeReader(InputStream)
Creates a new UnicodeReader.
 o UnicodeReader(Reader)
Creates a new UnicodeReader.

Method Index

 o bad()
Do not use. Deprecated.
 o eof()
Determines if stream is has reach end of file.
 o flushLine()
Causes the next I/O operation to start at the beginning of the next input line.
 o hadEof()
Determines if reach end of file in a previous read.
 o read(char[])
Reads data into an array of chars.
 o read(char[], int, int)
Reads data into an array of chars.
 o readBoolean()
Reads an ASCII boolean value.
 o readChar()
Read an ASCII character and convert it into the internal char format.
 o readDouble()
Reads an ASCII decimal floating point number.
 o readFloat()
Reads an ASCII decimal floating point number.
 o readFully(char[])
Reads chars, blocking until all chars are read.
 o readFully(char[], int, int)
Reads chars, blocking until all chars are read.
 o readInt()
Reads an ASCII decimal integer.
 o readLine()
Reads in a line that has been terminated by a \n, \r, \r\n or EOF.
 o readLong()
Reads an ASCII decimal long.
 o readShort()
Reads an ASCII decimal short.
 o readUnsignedShort()
Reads an ASCII decimal unsigned short.
 o readWord()
Reads a word.
 o skipChars(int)
Skips chars, block until all chars are skipped.

Constructors

 o UnicodeReader
 public UnicodeReader(InputStream input)
Creates a new UnicodeReader.

Parameters:
input - the input stream which to read from.
 o UnicodeReader
 public UnicodeReader(Reader input)
Creates a new UnicodeReader.

Parameters:
input - the input reader

Methods

 o bad
 public boolean bad()
Note: bad() is deprecated.

Do not use. This method no longer does anything. Always returns false.

 o hadEof
 public boolean hadEof() throws IOException
Determines if reach end of file in a previous read. This differs from eof() in in that eof() will indicate end of file if only white space remains. This function only indicates if you actually reached end of file an a prevoius read. If only whitespace remains and you use readInt (readDouble, etc.) an exception will be thrown. Use this method to detect end of file only if direct access to the white space between tokens is important to your program and you handle the case of a file ending in white space properly.

Returns:
true if end of file was reached.
See Also:
eof
 o eof
 public boolean eof() throws IOException
Determines if stream is has reach end of file. Consumes white space up to next token. If your program needs that white space between tokens use hadEof() instead. eof() is the prefered way to detect end of file.

Returns:
true if end of file was reached or if only white space remained in the stream.
See Also:
hadEof
 o read
 public int read(char b[]) throws IOException
Reads data into an array of chars. This method blocks until some input is available.

Parameters:
b - the buffer into which the data is read.
Returns:
the actual number of chars read. -1 is returned when the end of the stream is reached. (In this case, the eof() member will return true.)
Throws: IOException
If an I/O error has occurred.
Overrides:
read in class Reader
 o read
 public int read(char b[],
                 int off,
                 int len) throws IOException
Reads data into an array of chars. This method blocks until some input is available.

Parameters:
b - the buffer into which the data is read.
off - the start offset of the data
len - the maximum number of chars read
Returns:
the actual number of chars read. -1 is returned when the end of the stream is reached. (In this case, the eof() member will return true.)
Throws: IOException
If an I/O error has occurred.
Overrides:
read in class FilterReader
 o readFully
 public void readFully(char b[]) throws IOException
Reads chars, blocking until all chars are read. If EOF is reached, the eof() member will return true.

Parameters:
b - the buffer into which the data is read
Throws: IOException
If an I/O error has occurred.
 o readFully
 public void readFully(char b[],
                       int off,
                       int len) throws IOException
Reads chars, blocking until all chars are read. If EOF is reached, the eof() member will return true.

Parameters:
b - the buffer into which the data is read
off - the start offset of the data
len - the maximum number of chars read
Throws: IOException
If an I/O error has occurred.
 o skipChars
 public int skipChars(int n) throws IOException
Skips chars, block until all chars are skipped.

Parameters:
n - the number of chars to be skipped
Returns:
the actual number of chars skipped.
Throws: IOException
If an I/O error has occurred.
 o readBoolean
 public boolean readBoolean() throws IOException
Reads an ASCII boolean value. It reads a word and determines if it represents true or false. Possible values are: true and false. The comparison is case insensitive. The eof() method will return true after this method has attempted to read beyond the end of file.

Returns:
the boolean.
Throws: IOException
If an I/O error has occurred.
Throws: NumberFormatException
If the next token in the input stream is not a valid boolean.
 o readShort
 public short readShort() throws IOException
Reads an ASCII decimal short. Shorts can be preceded by optional whitespace. whitespace is defined as SPACE, TAB, CR, or NL. The eof() method will return true after this method has attempted to read beyond the end of file.

Returns:
the short.
Throws: IOException
If an I/O error has occurred.
See Also:
UnicodeReader@readInt
 o readUnsignedShort
 public int readUnsignedShort() throws IOException
Reads an ASCII decimal unsigned short. Unsigned shorts can be preceded by optional whitespace. whitespace is defined as SPACE, TAB, CR, or NL.

Returns:
an int representing the unsigned short.
Throws: IOException
If an I/O error has occurred.
See Also:
UnicodeReader@readInt
 o readChar
 public char readChar() throws IOException
Read an ASCII character and convert it into the internal char format. The eof() method will return true after this method has attempted to read beyond the end of file.

Returns:
the character.
Throws: IOException
If an I/O error occurred.
 o readInt
 public int readInt() throws IOException
Reads an ASCII decimal integer. Integers can be preceded by optional whitespace. whitespace is defined as SPACE, TAB, CR, or NL. The eof() method will return true after this method has attempted to read beyond the end of file.

Returns:
the integer.
Throws: IOException
If an I/O error has occurred.
 o readLong
 public long readLong() throws IOException
Reads an ASCII decimal long. Longs can be preceded by optional whitespace. whitespace is defined as SPACE, TAB, CR, or NL. The eof() method will return true after this method has attempted to read beyond the end of file.

Returns:
the long or 0 when EOF was reached.
Throws: IOException
If an I/O error has occurred.
 o readFloat
 public float readFloat() throws IOException
Reads an ASCII decimal floating point number. A floating point number is defined as follows: Floats can be preceded by optional whitespace. whitespace is defined as SPACE, TAB, CR, or NL.
If an error on the format of the number is found, the bad() member will return true.

Returns:
the float.
Throws: IOException
If an I/O error has occurred.
 o readDouble
 public double readDouble() throws IOException
Reads an ASCII decimal floating point number. A floating point number is defined as follows: Doubles can be preceded by optional whitespace. whitespace is defined as SPACE, TAB, CR, or NL.
If an error on the format of the number is found, the bad() member will return true.

Returns:
the double.
Throws: IOException
If an I/O error has occurred.
 o readLine
 public String readLine() throws IOException
Reads in a line that has been terminated by a \n, \r, \r\n or EOF. The eof() method will return true if the read attempted to go beyond the end of file. The terminating line characters will not be part of the String that is returned.

Returns:
a String copy of the line or null if nothing more could be read.
Throws: IOException
If an I/O error has occurred.
 o readWord
 public String readWord() throws IOException
Reads a word. A word is a string of characters deliminated by whitespace or EOF. A word can be preceded by optional whitespace characters. Whitespace is defined as SPACE, TAB, CR, or NL.

Returns:
the word or null if EOF reached.
Throws: IOException
If an I/O error has occurred.
 o flushLine
 public void flushLine() throws IOException
Causes the next I/O operation to start at the beginning of the next input line. Lines are delimited by either cr, cr lf, or lf.

Throws: IOException
If an I/O error has occurred.

All Packages  Class Hierarchy  This Package  Previous  Next  Index