ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/jsr166/jsr166/src/main/java/util/TreeMap.java
(Generate patch)

Comparing jsr166/src/main/java/util/TreeMap.java (file contents):
Revision 1.23 by jsr166, Mon Jul 18 01:14:34 2005 UTC vs.
Revision 1.24 by jsr166, Sat Sep 10 20:01:23 2005 UTC

# Line 250 | Line 250 | public class TreeMap<K,V>
250      }
251  
252      /**
253 <     * Returns the value to which this map maps the specified key, or
254 <     * <tt>null</tt> if the map contains no mapping for the key.  A return
255 <     * value of <tt>null</tt> does not <i>necessarily</i> indicate that the
256 <     * map contains no mapping for the key; it's also possible that the map
257 <     * explicitly maps the key to <tt>null</tt>.  The {@link #containsKey
258 <     * containsKey} operation may be used to distinguish these two cases.
253 >     * Returns the value to which the specified key is mapped,
254 >     * or {@code null} if this map contains no mapping for the key.
255 >     *
256 >     * <p>More formally, if this map contains a mapping from a key
257 >     * {@code k} to a value {@code v} such that {@code key} compares
258 >     * equal to {@code k} according to the map's ordering, then this
259 >     * method returns {@code v}; otherwise it returns {@code null}.
260 >     * (There can be at most one such mapping.)
261 >     *
262 >     * <p>A return value of {@code null} does not <i>necessarily</i>
263 >     * indicate that the map contains no mapping for the key; it's also
264 >     * possible that the map explicitly maps the key to {@code null}.
265 >     * The {@link #containsKey containsKey} operation may be used to
266 >     * distinguish these two cases.
267       *
260     * @param key key whose associated value is to be returned
261     * @return the value to which this map maps the specified key, or
262     *         <tt>null</tt> if the map contains no mapping for the key
268       * @throws ClassCastException if the specified key cannot be compared
269       *         with the keys currently in the map
270       * @throws NullPointerException if the specified key is null

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines