[cvs] / jsr166 / src / main / java / util / NavigableMap.java Repository:
ViewVC logotype

Diff of /jsr166/src/main/java/util/NavigableMap.java

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.18, Fri Apr 21 06:45:18 2006 UTC revision 1.19, Fri Apr 21 21:37:48 2006 UTC
# Line 267  Line 267 
267       * submap either of whose endpoints lie outside its range.       * submap either of whose endpoints lie outside its range.
268       *       *
269       * @param fromKey low endpoint of the keys in the returned map       * @param fromKey low endpoint of the keys in the returned map
270       * @param fromInclusive true if the low endpoint ({@code fromKey}) is       * @param fromInclusive {@code true} if the low endpoint
271       *        to be included in the returned view       *        is to be included in the returned view
272       * @param toKey high endpoint of the keys in the returned map       * @param toKey high endpoint of the keys in the returned map
273       * @param toInclusive true if the high endpoint ({@code toKey}) is       * @param toInclusive {@code true} if the high endpoint
274       *        to be included in the returned view       *        is to be included in the returned view
275       * @return a view of the portion of this map whose keys range from       * @return a view of the portion of this map whose keys range from
276       *         {@code fromKey} to {@code toKey}       *         {@code fromKey} to {@code toKey}
277       * @throws ClassCastException if {@code fromKey} and {@code toKey}       * @throws ClassCastException if {@code fromKey} and {@code toKey}
# Line 301  Line 301 
301       * on an attempt to insert a key outside its range.       * on an attempt to insert a key outside its range.
302       *       *
303       * @param toKey high endpoint of the keys in the returned map       * @param toKey high endpoint of the keys in the returned map
304       * @param inclusive true if the high endpoint ({@code toKey}) is       * @param inclusive {@code true} if the high endpoint
305       *        to be included in the returned view       *        is to be included in the returned view
306       * @return a view of the portion of this map whose keys are less than       * @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}       *         (or equal to, if {@code inclusive} is true) {@code toKey}
308       * @throws ClassCastException if {@code toKey} is not compatible       * @throws ClassCastException if {@code toKey} is not compatible
# Line 330  Line 330 
330       * on an attempt to insert a key outside its range.       * on an attempt to insert a key outside its range.
331       *       *
332       * @param fromKey low endpoint of the keys in the returned map       * @param fromKey low endpoint of the keys in the returned map
333       * @param inclusive true if the low endpoint ({@code fromKey}) is       * @param inclusive {@code true} if the low endpoint
334       *        to be included in the returned view       *        is to be included in the returned view
335       * @return a view of the portion of this map whose keys are greater than       * @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}       *         (or equal to, if {@code inclusive} is true) {@code fromKey}
337       * @throws ClassCastException if {@code fromKey} is not compatible       * @throws ClassCastException if {@code fromKey} is not compatible
# Line 347  Line 347 
347       *         bounds of the range       *         bounds of the range
348       */       */
349      NavigableMap<K,V> tailMap(K fromKey, boolean inclusive);      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  }  }

Legend:
Removed from v.1.18  
changed lines
  Added in v.1.19

Doug Lea
ViewVC Help
Powered by ViewVC 1.0.8