11 |
|
/** |
12 |
|
* Red-Black tree based implementation of the <tt>NavigableMap</tt> interface. |
13 |
|
* This class guarantees that the map will be in ascending key order, sorted |
14 |
< |
* according to the <i>natural order</i> for the key's class (see |
14 |
> |
* according to the <i>natural order</i> for the keys' class (see |
15 |
|
* <tt>Comparable</tt>), or by the comparator provided at creation time, |
16 |
|
* depending on which constructor is used.<p> |
17 |
|
* |
542 |
|
* @param key key with which the specified value is to be associated. |
543 |
|
* @param value value to be associated with the specified key. |
544 |
|
* |
545 |
< |
* @return previous value associated with specified key, or <tt>null</tt> |
545 |
> |
* @return the previous value associated with specified key, or <tt>null</tt> |
546 |
|
* if there was no mapping for key. A <tt>null</tt> return can |
547 |
|
* also indicate that the map previously associated <tt>null</tt> |
548 |
|
* with the specified key. |
591 |
|
* Removes the mapping for this key from this TreeMap if present. |
592 |
|
* |
593 |
|
* @param key key for which mapping should be removed |
594 |
< |
* @return previous value associated with specified key, or <tt>null</tt> |
594 |
> |
* @return the previous value associated with specified key, or <tt>null</tt> |
595 |
|
* if there was no mapping for key. A <tt>null</tt> return can |
596 |
|
* also indicate that the map previously associated |
597 |
|
* <tt>null</tt> with the specified key. |
670 |
|
/** |
671 |
|
* Returns a key-value mapping associated with the greatest |
672 |
|
* key in this map, or <tt>null</tt> if the map is empty. |
673 |
– |
* The returned entry does <em>not</em> support |
674 |
– |
* the <tt>Entry.setValue</tt> method. |
673 |
|
* |
674 |
|
* @return an Entry with greatest key, or <tt>null</tt> |
675 |
|
* if the map is empty. |
1143 |
|
* the key-value mappings in <tt>m</tt> whose keys are less than or equal |
1144 |
|
* to <tt>high</tt>: |
1145 |
|
* <pre> |
1146 |
< |
* NavigableMap head = m.headMap(high+"\0"); |
1146 |
> |
* NavigableMap head = m.navigableHeadMap(high+"\0"); |
1147 |
|
* </pre> |
1148 |
|
* |
1149 |
|
* @param toKey high endpoint (exclusive) of the headMap. |
1183 |
|
* are strings. The following idiom obtains a view containing |
1184 |
|
* all of the key-value mappings in <tt>m</tt> whose keys are strictly |
1185 |
|
* greater than <tt>low</tt>: <pre> |
1186 |
< |
* NavigableMap tail = m.tailMap(low+"\0"); |
1186 |
> |
* NavigableMap tail = m.navigableTailMap(low+"\0"); |
1187 |
|
* </pre> |
1188 |
|
* |
1189 |
|
* @param fromKey low endpoint (inclusive) of the tailMap. |