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 |
|
*/ |
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); |
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 |
|
*/ |
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 |
|
|
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 |
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 |
|
*/ |
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 |
|
*/ |