267 |
|
* submap either of whose endpoints lie outside its range. |
268 |
|
* |
269 |
|
* @param fromKey low endpoint of the keys in the returned map |
270 |
< |
* @param fromInclusive true if the low endpoint ({@code fromKey}) is |
271 |
< |
* to be included in the returned view |
270 |
> |
* @param fromInclusive {@code true} if the low endpoint |
271 |
> |
* is to be included in the returned view |
272 |
|
* @param toKey high endpoint of the keys in the returned map |
273 |
< |
* @param toInclusive true if the high endpoint ({@code toKey}) is |
274 |
< |
* to be included in the returned view |
273 |
> |
* @param toInclusive {@code true} if the high endpoint |
274 |
> |
* is to be included in the returned view |
275 |
|
* @return a view of the portion of this map whose keys range from |
276 |
|
* {@code fromKey} to {@code toKey} |
277 |
|
* @throws ClassCastException if {@code fromKey} and {@code toKey} |
301 |
|
* on an attempt to insert a key outside its range. |
302 |
|
* |
303 |
|
* @param toKey high endpoint of the keys in the returned map |
304 |
< |
* @param inclusive true if the high endpoint ({@code toKey}) is |
305 |
< |
* to be included in the returned view |
304 |
> |
* @param inclusive {@code true} if the high endpoint |
305 |
> |
* is to be included in the returned view |
306 |
|
* @return a view of the portion of this map whose keys are less than |
307 |
|
* (or equal to, if {@code inclusive} is true) {@code toKey} |
308 |
|
* @throws ClassCastException if {@code toKey} is not compatible |
330 |
|
* on an attempt to insert a key outside its range. |
331 |
|
* |
332 |
|
* @param fromKey low endpoint of the keys in the returned map |
333 |
< |
* @param inclusive true if the low endpoint ({@code fromKey}) is |
334 |
< |
* to be included in the returned view |
333 |
> |
* @param inclusive {@code true} if the low endpoint |
334 |
> |
* is to be included in the returned view |
335 |
|
* @return a view of the portion of this map whose keys are greater than |
336 |
|
* (or equal to, if {@code inclusive} is true) {@code fromKey} |
337 |
|
* @throws ClassCastException if {@code fromKey} is not compatible |
347 |
|
* bounds of the range |
348 |
|
*/ |
349 |
|
NavigableMap<K,V> tailMap(K fromKey, boolean inclusive); |
350 |
+ |
|
351 |
+ |
/** |
352 |
+ |
* Equivalent to {@code subMap(fromKey, true, toKey, false)} |
353 |
+ |
* but with a return type conforming to the {@code SortedMap} interface. |
354 |
+ |
* |
355 |
+ |
* <p>{@inheritDoc} |
356 |
+ |
* |
357 |
+ |
* @throws ClassCastException {@inheritDoc} |
358 |
+ |
* @throws NullPointerException {@inheritDoc} |
359 |
+ |
* @throws IllegalArgumentException {@inheritDoc} |
360 |
+ |
*/ |
361 |
+ |
SortedMap<K,V> subMap(K fromKey, K toKey); |
362 |
+ |
|
363 |
+ |
/** |
364 |
+ |
* Equivalent to {@code headMap(toKey, false)} |
365 |
+ |
* but with a return type conforming to the {@code SortedMap} interface. |
366 |
+ |
* |
367 |
+ |
* <p>{@inheritDoc} |
368 |
+ |
* |
369 |
+ |
* @throws ClassCastException {@inheritDoc} |
370 |
+ |
* @throws NullPointerException {@inheritDoc} |
371 |
+ |
* @throws IllegalArgumentException {@inheritDoc} |
372 |
+ |
*/ |
373 |
+ |
SortedMap<K,V> headMap(K toKey); |
374 |
+ |
|
375 |
+ |
/** |
376 |
+ |
* Equivalent to {@code tailMap(fromKey, true)} |
377 |
+ |
* but with a return type conforming to the {@code SortedMap} interface. |
378 |
+ |
* |
379 |
+ |
* <p>{@inheritDoc} |
380 |
+ |
* |
381 |
+ |
* @throws ClassCastException {@inheritDoc} |
382 |
+ |
* @throws NullPointerException {@inheritDoc} |
383 |
+ |
* @throws IllegalArgumentException {@inheritDoc} |
384 |
+ |
*/ |
385 |
+ |
SortedMap<K,V> tailMap(K fromKey); |
386 |
|
} |