--- jsr166/src/jsr166x/NavigableMap.java 2011/03/15 19:47:02 1.6
+++ jsr166/src/jsr166x/NavigableMap.java 2012/12/29 23:55:19 1.10
@@ -34,7 +34,7 @@ import java.util.*;
* pollLastEntry that return and/or remove the least and
* greatest mappings, if any exist, else returning null.
*
- *
Implementations of entry-returning methods are expected to
+ *
Implementations of entry-returning methods are expected to
* return Map.Entry pairs representing snapshots of mappings
* at the time they were produced, and thus generally do not
* support the optional Entry.setValue method. Note however
@@ -51,13 +51,13 @@ public interface NavigableMap exten
* greater than or equal to the given key, or null if there is
* no such entry.
*
- * @param key the key.
+ * @param key the key
* @return an Entry associated with ceiling of given key, or null
- * if there is no such Entry.
+ * if there is no such Entry
* @throws ClassCastException if key cannot be compared with the keys
- * currently in the map.
+ * currently in the map
* @throws NullPointerException if key is null and this map
- * does not support null keys.
+ * does not support null keys
*/
public Map.Entry ceilingEntry(K key);
@@ -65,13 +65,13 @@ public interface NavigableMap exten
* Returns least key greater than or equal to the given key, or
* null if there is no such key.
*
- * @param key the key.
+ * @param key the key
* @return the ceiling key, or null
- * if there is no such key.
+ * if there is no such key
* @throws ClassCastException if key cannot be compared with the keys
- * currently in the map.
+ * currently in the map
* @throws NullPointerException if key is null and this map
- * does not support null keys.
+ * does not support null keys
*/
public K ceilingKey(K key);
@@ -80,13 +80,13 @@ public interface NavigableMap exten
* key strictly less than the given key, or null if there is no
* such entry.
*
- * @param key the key.
+ * @param key the key
* @return an Entry with greatest key less than the given
- * key, or null if there is no such Entry.
+ * key, or null if there is no such Entry
* @throws ClassCastException if key cannot be compared with the keys
- * currently in the map.
+ * currently in the map
* @throws NullPointerException if key is null and this map
- * does not support null keys.
+ * does not support null keys
*/
public Map.Entry lowerEntry(K key);
@@ -94,13 +94,13 @@ public interface NavigableMap exten
* Returns the greatest key strictly less than the given key, or
* null if there is no such key.
*
- * @param key the key.
+ * @param key the key
* @return the greatest key less than the given
- * key, or null if there is no such key.
+ * key, or null if there is no such key
* @throws ClassCastException if key cannot be compared with the keys
- * currently in the map.
+ * currently in the map
* @throws NullPointerException if key is null and this map
- * does not support null keys.
+ * does not support null keys
*/
public K lowerKey(K key);
@@ -109,13 +109,13 @@ public interface NavigableMap exten
* less than or equal to the given key, or null if there
* is no such entry.
*
- * @param key the key.
+ * @param key the key
* @return an Entry associated with floor of given key, or null
- * if there is no such Entry.
+ * if there is no such Entry
* @throws ClassCastException if key cannot be compared with the keys
- * currently in the map.
+ * currently in the map
* @throws NullPointerException if key is null and this map
- * does not support null keys.
+ * does not support null keys
*/
public Map.Entry floorEntry(K key);
@@ -124,13 +124,13 @@ public interface NavigableMap exten
* less than or equal to the given key, or null if there
* is no such key.
*
- * @param key the key.
+ * @param key the key
* @return the floor of given key, or null if there is no
- * such key.
+ * such key
* @throws ClassCastException if key cannot be compared with the keys
- * currently in the map.
+ * currently in the map
* @throws NullPointerException if key is null and this map
- * does not support null keys.
+ * does not support null keys
*/
public K floorKey(K key);
@@ -139,13 +139,13 @@ public interface NavigableMap exten
* strictly greater than the given key, or null if there
* is no such entry.
*
- * @param key the key.
+ * @param key the key
* @return an Entry with least key greater than the given key, or
- * null if there is no such Entry.
+ * null if there is no such Entry
* @throws ClassCastException if key cannot be compared with the keys
- * currently in the map.
+ * currently in the map
* @throws NullPointerException if key is null and this map
- * does not support null keys.
+ * does not support null keys
*/
public Map.Entry higherEntry(K key);
@@ -153,13 +153,13 @@ public interface NavigableMap exten
* Returns the least key strictly greater than the given key, or
* null if there is no such key.
*
- * @param key the key.
+ * @param key the key
* @return the least key greater than the given key, or
- * null if there is no such key.
+ * null if there is no such key
* @throws ClassCastException if key cannot be compared with the keys
- * currently in the map.
+ * currently in the map
* @throws NullPointerException if key is null and this map
- * does not support null keys.
+ * does not support null keys
*/
public K higherKey(K key);
@@ -168,7 +168,7 @@ public interface NavigableMap exten
* key in this map, or null if the map is empty.
*
* @return an Entry with least key, or null
- * if the map is empty.
+ * if the map is empty
*/
public Map.Entry firstEntry();
@@ -177,7 +177,7 @@ public interface NavigableMap exten
* key in this map, or null if the map is empty.
*
* @return an Entry with greatest key, or null
- * if the map is empty.
+ * if the map is empty
*/
public Map.Entry lastEntry();
@@ -186,7 +186,7 @@ public interface NavigableMap exten
* the least key in this map, or null if the map is empty.
*
* @return the removed first entry of this map, or null
- * if the map is empty.
+ * if the map is empty
*/
public Map.Entry pollFirstEntry();
@@ -195,7 +195,7 @@ public interface NavigableMap exten
* the greatest key in this map, or null if the map is empty.
*
* @return the removed last entry of this map, or null
- * if the map is empty.
+ * if the map is empty
*/
public Map.Entry pollLastEntry();
@@ -212,7 +212,7 @@ public interface NavigableMap exten
* operations. It does not support the add or addAll
* operations.
*
- * @return a set view of the keys contained in this map.
+ * @return a set view of the keys contained in this map
*/
Set descendingKeySet();
@@ -232,7 +232,7 @@ public interface NavigableMap exten
* operations. It does not support the add or
* addAll operations.
*
- * @return a set view of the mappings contained in this map.
+ * @return a set view of the mappings contained in this map
*/
Set> descendingEntrySet();
@@ -242,22 +242,22 @@ public interface NavigableMap exten
* fromKey and toKey are equal, the returned sorted map
* is empty.) The returned sorted map is backed by this map, so changes
* in the returned sorted map are reflected in this map, and vice-versa.
-
- * @param fromKey low endpoint (inclusive) of the subMap.
- * @param toKey high endpoint (exclusive) of the subMap.
+ *
+ * @param fromKey low endpoint (inclusive) of the subMap
+ * @param toKey high endpoint (exclusive) of the subMap
*
* @return a view of the portion of this map whose keys range from
- * fromKey, inclusive, to toKey, exclusive.
+ * fromKey, inclusive, to toKey, exclusive
*
* @throws ClassCastException if fromKey and
* toKey cannot be compared to one another using this
* map's comparator (or, if the map has no comparator, using
- * natural ordering).
+ * natural ordering)
* @throws IllegalArgumentException if fromKey is greater
- * than toKey.
+ * than toKey
* @throws NullPointerException if fromKey or
* toKey is null and this map does not support
- * null keys.
+ * null keys
*/
public NavigableMap subMap(K fromKey, K toKey);
@@ -266,15 +266,15 @@ public interface NavigableMap exten
* than toKey. The returned sorted map is backed by this map, so
* changes in the returned sorted map are reflected in this map, and
* vice-versa.
- * @param toKey high endpoint (exclusive) of the headMap.
+ * @param toKey high endpoint (exclusive) of the headMap
* @return a view of the portion of this map whose keys are strictly
- * less than toKey.
+ * less than toKey
*
* @throws ClassCastException if toKey is not compatible
* with this map's comparator (or, if the map has no comparator,
- * if toKey does not implement Comparable).
+ * if toKey does not implement Comparable)
* @throws NullPointerException if toKey is null
- * and this map does not support null keys.
+ * and this map does not support null keys
*/
public NavigableMap headMap(K toKey);
@@ -283,14 +283,14 @@ public interface NavigableMap exten
* greater than or equal to fromKey. The returned sorted
* map is backed by this map, so changes in the returned sorted
* map are reflected in this map, and vice-versa.
- * @param fromKey low endpoint (inclusive) of the tailMap.
+ * @param fromKey low endpoint (inclusive) of the tailMap
* @return a view of the portion of this map whose keys are greater
- * than or equal to fromKey.
+ * than or equal to fromKey
* @throws ClassCastException if fromKey is not compatible
* with this map's comparator (or, if the map has no comparator,
- * if fromKey does not implement Comparable).
+ * if fromKey does not implement Comparable)
* @throws NullPointerException if fromKey is null
- * and this map does not support null keys.
+ * and this map does not support null keys
*/
- public NavigableMap tailMap(K fromKey);
+ public NavigableMap tailMap(K fromKey);
}