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

Comparing jsr166/src/jsr166x/NavigableSet.java (file contents):
Revision 1.7 by jsr166, Sun Nov 18 18:03:10 2012 UTC vs.
Revision 1.8 by jsr166, Sat Dec 29 23:55:19 2012 UTC

# Line 57 | Line 57 | public interface NavigableSet<E> extends
57       * @return the greatest element less than the given element, or
58       * <tt>null</tt> if there is no such element.
59       * @throws ClassCastException if o cannot be compared with the elements
60 <     *            currently in the set.
60 >     *            currently in the set
61       * @throws NullPointerException if o is <tt>null</tt>
62       * and this set deas not permit <tt>null</tt> elements
63       */
# Line 69 | Line 69 | public interface NavigableSet<E> extends
69       *
70       * @param o the value to match
71       * @return the greatest element less than or equal to given
72 <     * element, or <tt>null</tt> if there is no such element.
72 >     * element, or <tt>null</tt> if there is no such element
73       * @throws ClassCastException if o cannot be compared with the elements
74 <     *            currently in the set.
75 <     * @throws NullPointerException if o is <tt>null</tt>.
74 >     *            currently in the set
75 >     * @throws NullPointerException if o is <tt>null</tt>
76       * and this set deas not permit <tt>null</tt> elements
77       */
78      public E floor(E o);
# Line 85 | Line 85 | public interface NavigableSet<E> extends
85       * @return the least element greater than the given element, or
86       * <tt>null</tt> if there is no such element.
87       * @throws ClassCastException if o cannot be compared with the elements
88 <     *            currently in the set.
88 >     *            currently in the set
89       * @throws NullPointerException if o is <tt>null</tt>
90       * and this set deas not permit <tt>null</tt> elements
91       */
# Line 94 | Line 94 | public interface NavigableSet<E> extends
94      /**
95       * Retrieves and removes the first (lowest) element.
96       *
97 <     * @return the first element, or <tt>null</tt> if empty.
97 >     * @return the first element, or <tt>null</tt> if empty
98       */
99      public E pollFirst();
100  
101      /**
102       * Retrieves and removes the last (highest) element.
103       *
104 <     * @return the last element, or <tt>null</tt> if empty.
104 >     * @return the last element, or <tt>null</tt> if empty
105       */
106      public E pollLast();
107  
# Line 120 | Line 120 | public interface NavigableSet<E> extends
120       * sorted set is empty.)  The returned sorted set is backed by this set,
121       * so changes in the returned sorted set are reflected in this set, and
122       * vice-versa.
123 <     * @param fromElement low endpoint (inclusive) of the subSet.
124 <     * @param toElement high endpoint (exclusive) of the subSet.
123 >     * @param fromElement low endpoint (inclusive) of the subSet
124 >     * @param toElement high endpoint (exclusive) of the subSet
125       * @return a view of the portion of this set whose elements range from
126       *         <tt>fromElement</tt>, inclusive, to <tt>toElement</tt>,
127 <     *         exclusive.
127 >     *         exclusive
128       * @throws ClassCastException if <tt>fromElement</tt> and
129       *         <tt>toElement</tt> cannot be compared to one another using
130       *         this set's comparator (or, if the set has no comparator,
131 <     *         using natural ordering).
131 >     *         using natural ordering)
132       * @throws IllegalArgumentException if <tt>fromElement</tt> is
133 <     * greater than <tt>toElement</tt>.
133 >     * greater than <tt>toElement</tt>
134       * @throws NullPointerException if <tt>fromElement</tt> or
135       *         <tt>toElement</tt> is <tt>null</tt>
136       * and this set deas not permit <tt>null</tt> elements
# Line 142 | Line 142 | public interface NavigableSet<E> extends
142       * less than <tt>toElement</tt>.  The returned sorted set is backed by
143       * this set, so changes in the returned sorted set are reflected in this
144       * set, and vice-versa.
145 <     * @param toElement high endpoint (exclusive) of the headSet.
145 >     * @param toElement high endpoint (exclusive) of the headSet
146       * @return a view of the portion of this set whose elements are strictly
147 <     *         less than toElement.
147 >     *         less than toElement
148       * @throws ClassCastException if <tt>toElement</tt> is not compatible
149       *         with this set's comparator (or, if the set has no comparator,
150 <     *         if <tt>toElement</tt> does not implement <tt>Comparable</tt>).
150 >     *         if <tt>toElement</tt> does not implement <tt>Comparable</tt>)
151       * @throws NullPointerException if <tt>toElement</tt> is <tt>null</tt>
152       * and this set deas not permit <tt>null</tt> elements
153       */
# Line 158 | Line 158 | public interface NavigableSet<E> extends
158       * greater than or equal to <tt>fromElement</tt>.  The returned
159       * sorted set is backed by this set, so changes in the returned
160       * sorted set are reflected in this set, and vice-versa.
161 <     * @param fromElement low endpoint (inclusive) of the tailSet.
161 >     * @param fromElement low endpoint (inclusive) of the tailSet
162       * @return a view of the portion of this set whose elements are
163 <     * greater than or equal to <tt>fromElement</tt>.
163 >     * greater than or equal to <tt>fromElement</tt>
164       * @throws ClassCastException if <tt>fromElement</tt> is not
165       * compatible with this set's comparator (or, if the set has no
166       * comparator, if <tt>fromElement</tt> does not implement
167 <     * <tt>Comparable</tt>).
167 >     * <tt>Comparable</tt>)
168       * @throws NullPointerException if <tt>fromElement</tt> is <tt>null</tt>
169       * and this set deas not permit <tt>null</tt> elements
170       */

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines