joptsimple.internal
Class AbbreviationMap<V>

java.lang.Object
  extended by joptsimple.internal.AbbreviationMap<V>
Type Parameters:
V - a constraint on the types of the values in the map

public class AbbreviationMap<V>
extends Object

A map whose keys are strings; when a key/value pair is added to the map, the longest unique abbreviations of that key are added as well, and associated with the value. Thus:

   
   abbreviations.put( "good", "bye" );
   
 

would make it such that you could retrieve the value "bye" from the map using the keys "good", "goo", "go", and "g". A subsequent invocation of:

   
   abbreviations.put( "go", "fish" );
   
 

would make it such that you could retrieve the value "bye" using the keys "good" and "goo", and the value "fish" using the key "go". The key "g" would yield null, since it would no longer be a unique abbreviation.

The data structure is much like a "trie".

Version:
$Id: AbbreviationMap.java,v 1.14 2009/10/25 18:37:08 pholser Exp $
Author:
Paul Holser
See Also:
Perl's Text::Abbrev module

Constructor Summary
AbbreviationMap()
           
 
Method Summary
 boolean contains(String aKey)
          Tells whether the given key is in the map, or whether the given key is a unique abbreviation of a key that is in the map.
 V get(String aKey)
          Answers the value associated with the given key.
 void put(String aKey, V newValue)
          Associates a given value with a given key.
 void putAll(Iterable<String> keys, V newValue)
          Associates a given value with a given set of keys.
 void remove(String aKey)
          If the map contains the given key, dissociates the key from its value.
 Map<String,V> toJavaUtilMap()
          Gives a Java map representation of this abbreviation map.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

AbbreviationMap

public AbbreviationMap()
Method Detail

contains

public boolean contains(String aKey)

Tells whether the given key is in the map, or whether the given key is a unique abbreviation of a key that is in the map.

Parameters:
aKey - key to look up
Returns:
true if key is present in the map
Throws:
NullPointerException - if key is null

get

public V get(String aKey)

Answers the value associated with the given key. The key can be a unique abbreviation of a key that is in the map.

Parameters:
aKey - key to look up
Returns:
the value associated with aKey; or null if there is no such value or aKey is not a unique abbreviation of a key in the map
Throws:
NullPointerException - if aKey is null

put

public void put(String aKey,
                V newValue)

Associates a given value with a given key. If there was a previous association, the old value is replaced with the new one.

Parameters:
aKey - key to create in the map
newValue - value to associate with the key
Throws:
NullPointerException - if aKey or newValue is null
IllegalArgumentException - if aKey is a zero-length string

putAll

public void putAll(Iterable<String> keys,
                   V newValue)

Associates a given value with a given set of keys. If there was a previous association, the old value is replaced with the new one.

Parameters:
keys - keys to create in the map
newValue - value to associate with the key
Throws:
NullPointerException - if keys or newValue is null
IllegalArgumentException - if any of keys is a zero-length string

remove

public void remove(String aKey)

If the map contains the given key, dissociates the key from its value.

Parameters:
aKey - key to remove
Throws:
NullPointerException - if aKey is null
IllegalArgumentException - if aKey is a zero-length string

toJavaUtilMap

public Map<String,V> toJavaUtilMap()
Gives a Java map representation of this abbreviation map.

Returns:
a Java map corresponding to this abbreviation map


Copyright © 2011. All Rights Reserved.