--- jsr166/src/jsr166x/NavigableMap.java 2004/12/26 20:13:15 1.4 +++ jsr166/src/jsr166x/NavigableMap.java 2012/11/18 18:03:10 1.9 @@ -1,7 +1,7 @@ /* * Written by Doug Lea with assistance from members of JCP JSR-166 * Expert Group and released to the public domain, as explained at - * http://creativecommons.org/licenses/publicdomain + * http://creativecommons.org/publicdomain/zero/1.0/ */ package jsr166x; @@ -28,13 +28,13 @@ import java.util.*; * performance of ascending traversals is likely to be faster than * descending traversals. Notice that it is possible to perform * subrannge traversals in either direction using SubMap. - * + * *

This interface additionally defines methods firstEntry, * pollFirstEntry, lastEntry, and * 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 @@ -43,14 +43,14 @@ import java.util.*; * * @author Doug Lea * @param the type of keys maintained by this map - * @param the type of mapped values + * @param the type of mapped values */ public interface NavigableMap extends SortedMap { /** * Returns a key-value mapping associated with the least key * greater than or equal to the given key, or null if there is - * no such entry. - * + * no such entry. + * * @param key the key. * @return an Entry associated with ceiling of given key, or null * if there is no such Entry. @@ -64,7 +64,7 @@ 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. * @return the ceiling key, or null * if there is no such key. @@ -78,8 +78,8 @@ public interface NavigableMap exten /** * Returns a key-value mapping associated with the greatest * key strictly less than the given key, or null if there is no - * such entry. - * + * such entry. + * * @param key the key. * @return an Entry with greatest key less than the given * key, or null if there is no such Entry. @@ -93,7 +93,7 @@ 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. * @return the greatest key less than the given * key, or null if there is no such key. @@ -108,7 +108,7 @@ public interface NavigableMap exten * Returns a key-value mapping associated with the greatest key * less than or equal to the given key, or null if there * is no such entry. - * + * * @param key the key. * @return an Entry associated with floor of given key, or null * if there is no such Entry. @@ -123,7 +123,7 @@ public interface NavigableMap exten * Returns the greatest key * less than or equal to the given key, or null if there * is no such key. - * + * * @param key the key. * @return the floor of given key, or null if there is no * such key. @@ -138,7 +138,7 @@ public interface NavigableMap exten * Returns a key-value mapping associated with the least key * strictly greater than the given key, or null if there * is no such entry. - * + * * @param key the key. * @return an Entry with least key greater than the given key, or * null if there is no such Entry. @@ -152,7 +152,7 @@ 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. * @return the least key greater than the given key, or * null if there is no such key. @@ -166,8 +166,8 @@ public interface NavigableMap exten /** * Returns a key-value mapping associated with the least * key in this map, or null if the map is empty. - * - * @return an Entry with least key, or null + * + * @return an Entry with least key, or null * if the map is empty. */ public Map.Entry firstEntry(); @@ -175,7 +175,7 @@ public interface NavigableMap exten /** * Returns a key-value mapping associated with the greatest * key in this map, or null if the map is empty. - * + * * @return an Entry with greatest key, or null * if the map is empty. */ @@ -184,7 +184,7 @@ public interface NavigableMap exten /** * Removes and returns a key-value mapping associated with * 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. */ @@ -193,7 +193,7 @@ public interface NavigableMap exten /** * Removes and returns a key-value mapping associated with * 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. */ @@ -242,7 +242,7 @@ 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. * @@ -265,7 +265,7 @@ public interface NavigableMap exten * Returns a view of the portion of this map whose keys are strictly less * 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. + * vice-versa. * @param toKey high endpoint (exclusive) of the headMap. * @return a view of the portion of this map whose keys are strictly * less than toKey. @@ -292,5 +292,5 @@ public interface NavigableMap exten * @throws NullPointerException if fromKey is null * and this map does not support null keys. */ - public NavigableMap tailMap(K fromKey); + public NavigableMap tailMap(K fromKey); }