chn.util
Class ConsoleIO

java.lang.Object
  |
  +--chn.util.SimpleIO
        |
        +--chn.util.ConsoleIO

public class ConsoleIO

extends SimpleIO

Fields inherited from class chn.util.SimpleIO

delimiters, in, tokens

Constructor Summary

ConsoleIO()
Constructs the ConsoleIO object with default delimiters, space, tab, formfeed.

ConsoleIO(java.lang.String delims)
Constructs the ConsoleIO object with given delimiters.

Method Summary

double	promptDblRange(java.lang.String prompt, double min, double max) Flushes any remaining tokens on the current input line, then prompts the user with the given prompt parameter.
double	promptDouble(java.lang.String prompt) Flushes any remaining tokens on the current input line, then prompts the user with the given prompt parameter.
int	promptInt(java.lang.String prompt) Flushes any remaining tokens on the current input line, then prompts the user with the given prompt parameter.
int	promptIntRange(java.lang.String prompt, int min, int max) Flushes any remaining tokens on the current input line, then prompts the user with the given prompt parameter.
java.lang.String	promptLine(java.lang.String prompt) Flushes any remaining tokens on the current input line, then prompts the user with the given prompt parameter.
java.lang.String	promptToken(java.lang.String prompt) Flushes any remaining tokens on the current input line, then prompts the user with the given prompt parameter.
double	readDouble() Reads and returns the next double from the current line.
int	readInt() Reads and returns the next integer from the current line.

Methods inherited from class chn.util.SimpleIO

readBoolean, readLine, readToken

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ConsoleIO

public ConsoleIO()

Constructs the ConsoleIO object with default delimiters, space, tab, formfeed. Newline and return characters terminate the input of the current line.

ConsoleIO

public ConsoleIO(java.lang.String delims)

Constructs the ConsoleIO object with given delimiters. Newline and return characters terminate the input of the current line.

Method Detail

promptToken

public java.lang.String promptToken(java.lang.String prompt)

Flushes any remaining tokens on the current input line, then prompts the user with the given prompt parameter. Reads and returns the next token from the current line. A token is a String of characters separated by the specified delimiters. If the current input line has no more unread tokens, reads the first token from the first non-empty line entered.

Returns:

the next String token from input, as determined by delimiters

readInt

public int readInt()

Reads and returns the next integer from the current line. If the current input line has no more unread tokens, reads the first token from the first non-empty line entered. If the next token is not the correct format for an integer, then a message is printed, the remainder of the current line is flushed, and this method reads the next token from the next non-empty line entered.

Overrides:

readInt in class SimpleIO

Returns:

next integer from input

promptInt

public int promptInt(java.lang.String prompt)

Flushes any remaining tokens on the current input line, then prompts the user with the given prompt parameter. Reads and returns the next integer from the current line. If the current input line has no more unread tokens, reads the first token from the first non-empty line entered. If the next token is not the correct format for an integer, then a message is printed, the remainder of the current line is flushed, and this method reads the next token from the next non-empty line entered.

Returns:

next integer from input

promptIntRange

public int promptIntRange(java.lang.String prompt,
                          int min,
                          int max)

Flushes any remaining tokens on the current input line, then prompts the user with the given prompt parameter. Reads and returns the next integer from the current line. If the current input line has no more unread tokens, reads the first token from the first non-empty line entered. If the next token is not the correct format for an integer, then a message is printed, the remainder of the current line is flushed, and this method reads the next token from the next non-empty line entered. precondition: min <= max

Returns:

next integer from input that is in range

readDouble

public double readDouble()

Reads and returns the next double from the current line. If the current input line has no more unread tokens, reads the first token from the first non-empty line entered. If the next token is not the correct format for a double, then a message is printed, the remainder of the current line is flushed, and this method reads the next token from the next non-empty line entered.

Overrides:

readDouble in class SimpleIO

Returns:

the next double from input

promptDouble

public double promptDouble(java.lang.String prompt)

Flushes any remaining tokens on the current input line, then prompts the user with the given prompt parameter. Reads and returns the next double from the current line. If the current input line has no more unread tokens, reads the first token from the first non-empty line entered. If the next token is not the correct format for a double, then a message is printed, the remainder of the current line is flushed, and this method reads the next token from the next non-empty line entered.

Returns:

the next double from input

promptDblRange

public double promptDblRange(java.lang.String prompt,
                             double min,
                             double max)

Flushes any remaining tokens on the current input line, then prompts the user with the given prompt parameter. Reads and returns the next double from the current line. If the current input line has no more unread tokens, reads the first token from the first non-empty line entered. If the next token is not the correct format for a double, then a message is printed, the remainder of the current line is flushed, and this method reads the next token from the next non-empty line entered. precondition: min <= max

Returns:

the next double from input

promptLine

public java.lang.String promptLine(java.lang.String prompt)

Flushes any remaining tokens on the current input line, then prompts the user with the given prompt parameter. Then reads the next full line input as a String and returns it.

Returns:

next line read as a String