acm.util

Class OptionTable

java.lang.Object

java.util.AbstractMap<K,V>

java.util.HashMap

acm.util.OptionTable

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.util.Map

public class OptionTable
extends java.util.HashMap

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.util.AbstractMap

java.util.AbstractMap.SimpleEntry<K,V>, java.util.AbstractMap.SimpleImmutableEntry<K,V>

Constructor Summary

Constructors

Constructor and Description
OptionTable(java.util.Map map) Creates a new OptionTable from an existing map.
OptionTable(java.lang.String str) Creates a new OptionTable and initializes it from the specified string.
OptionTable(java.lang.String str, java.lang.String[] keys) Creates a new OptionTable from the specified string, checking to make sure that all keys exist in the string array keys.

Method Summary

Methods

Modifier and Type	Method and Description
double	getDoubleOption(java.lang.String key) Returns the double value associated with key in the option table, or 0.0 if no such value exists.
double	getDoubleOption(java.lang.String key, double defValue) Returns the double value associated with key in the option table or the specified default value if no such binding exists.
int	getIntOption(java.lang.String key) Returns the integer value associated with key in the option table, or 0 if no such value exists.
int	getIntOption(java.lang.String key, int defValue) Returns the integer value associated with key in the option table or the specified default value if no such binding exists.
java.lang.String	getOption(java.lang.String key) Returns the value associated with key in the option table, or null if no such value exists.
java.lang.String	getOption(java.lang.String key, java.lang.String defValue) Returns the value associated with key in the option table or the specified default value if no such binding exists.
boolean	isSpecified(java.lang.String key) Returns true if the key has been specified in the option table.

Methods inherited from class java.util.HashMap

clear, clone, containsKey, containsValue, entrySet, get, isEmpty, keySet, put, putAll, remove, size, values

Methods inherited from class java.util.AbstractMap

equals, hashCode, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map

equals, hashCode

Constructor Detail

OptionTable

public OptionTable(java.lang.String str)

Creates a new OptionTable and initializes it from the specified string. The options in str are in two possible forms:

1. key
2. key=value

The first option sets the value associated with the key to the empty string; the second supplies the value explicitly.

Parameters:

str - The option string that is parsed to initialize the table

OptionTable

public OptionTable(java.lang.String str,
           java.lang.String[] keys)

Creates a new OptionTable from the specified string, checking to make sure that all keys exist in the string array keys. If keys is null, checking is disabled.

Parameters:

str - The option string that is parsed to initialize the table

keys - An array of strings indicating the legal keys

OptionTable

public OptionTable(java.util.Map map)

Creates a new OptionTable from an existing map. Most clients will not need to use this method.

Parameters:

map - An existing key/value mapping

Method Detail

isSpecified

public boolean isSpecified(java.lang.String key)

Returns true if the key has been specified in the option table.

Parameters:

key - The key being checked

Returns:

true if key was specified in the option string

getOption

public java.lang.String getOption(java.lang.String key)

Returns the value associated with key in the option table, or null if no such value exists.

Parameters:

key - The key

Returns:

The corresponding option value

getOption

public java.lang.String getOption(java.lang.String key,
                         java.lang.String defValue)

Returns the value associated with key in the option table or the specified default value if no such binding exists.

Parameters:

key - The key

defValue - The default to use if the key is not found

Returns:

The corresponding option value

getIntOption

public int getIntOption(java.lang.String key)

Returns the integer value associated with key in the option table, or 0 if no such value exists.

Parameters:

key - The key

Returns:

The corresponding option value parsed as an integer

getIntOption

public int getIntOption(java.lang.String key,
               int defValue)

Returns the integer value associated with key in the option table or the specified default value if no such binding exists.

Parameters:

key - The key

defValue - The default to use if the key is not found

Returns:

The corresponding option value

getDoubleOption

public double getDoubleOption(java.lang.String key)

Returns the double value associated with key in the option table, or 0.0 if no such value exists.

Parameters:

key - The key

Returns:

The corresponding option value parsed as a double

getDoubleOption

public double getDoubleOption(java.lang.String key,
                     double defValue)

Returns the double value associated with key in the option table or the specified default value if no such binding exists.

Parameters:

key - The key

defValue - The default to use if the key is not found

Returns:

The corresponding option value