145 |
|
* that do allow null elements are strongly encouraged <i>not</i> to |
146 |
|
* take advantage of the ability to insert nulls. This is so because |
147 |
|
* {@code null} is used as a special return value by various methods |
148 |
< |
* to indicated that the deque is empty. |
148 |
> |
* to indicate that the deque is empty. |
149 |
|
* |
150 |
|
* <p>{@code Deque} implementations generally do not define |
151 |
|
* element-based versions of the {@code equals} and {@code hashCode} |
323 |
|
* @return {@code true} if an element was removed as a result of this call |
324 |
|
* @throws ClassCastException if the class of the specified element |
325 |
|
* is incompatible with this deque |
326 |
< |
* (<a href="../Collection.html#optional-restrictions">optional</a>) |
327 |
< |
* @throws NullPointerException if the specified element is null |
328 |
< |
* (<a href="../Collection.html#optional-restrictions">optional</a>) |
326 |
> |
* (<a href="{@docRoot}/../api/java/util/Collection.html#optional-restrictions">optional</a>) |
327 |
> |
* @throws NullPointerException if the specified element is null and this |
328 |
> |
* deque does not permit null elements |
329 |
> |
* (<a href="{@docRoot}/../api/java/util/Collection.html#optional-restrictions">optional</a>) |
330 |
|
*/ |
331 |
|
boolean removeFirstOccurrence(Object o); |
332 |
|
|
342 |
|
* @return {@code true} if an element was removed as a result of this call |
343 |
|
* @throws ClassCastException if the class of the specified element |
344 |
|
* is incompatible with this deque |
345 |
< |
* (<a href="../Collection.html#optional-restrictions">optional</a>) |
346 |
< |
* @throws NullPointerException if the specified element is null |
347 |
< |
* (<a href="../Collection.html#optional-restrictions">optional</a>) |
345 |
> |
* (<a href="{@docRoot}/../api/java/util/Collection.html#optional-restrictions">optional</a>) |
346 |
> |
* @throws NullPointerException if the specified element is null and this |
347 |
> |
* deque does not permit null elements |
348 |
> |
* (<a href="{@docRoot}/../api/java/util/Collection.html#optional-restrictions">optional</a>) |
349 |
|
*/ |
350 |
|
boolean removeLastOccurrence(Object o); |
351 |
|
|
500 |
|
* @return {@code true} if an element was removed as a result of this call |
501 |
|
* @throws ClassCastException if the class of the specified element |
502 |
|
* is incompatible with this deque |
503 |
< |
* (<a href="../Collection.html#optional-restrictions">optional</a>) |
504 |
< |
* @throws NullPointerException if the specified element is null |
505 |
< |
* (<a href="../Collection.html#optional-restrictions">optional</a>) |
503 |
> |
* (<a href="{@docRoot}/../api/java/util/Collection.html#optional-restrictions">optional</a>) |
504 |
> |
* @throws NullPointerException if the specified element is null and this |
505 |
> |
* deque does not permit null elements |
506 |
> |
* (<a href="{@docRoot}/../api/java/util/Collection.html#optional-restrictions">optional</a>) |
507 |
|
*/ |
508 |
|
boolean remove(Object o); |
509 |
|
|
516 |
|
* @return {@code true} if this deque contains the specified element |
517 |
|
* @throws ClassCastException if the class of the specified element |
518 |
|
* is incompatible with this deque |
519 |
< |
* (<a href="../Collection.html#optional-restrictions">optional</a>) |
520 |
< |
* @throws NullPointerException if the specified element is null |
521 |
< |
* (<a href="../Collection.html#optional-restrictions">optional</a>) |
519 |
> |
* (<a href="{@docRoot}/../api/java/util/Collection.html#optional-restrictions">optional</a>) |
520 |
> |
* @throws NullPointerException if the specified element is null and this |
521 |
> |
* deque does not permit null elements |
522 |
> |
* (<a href="{@docRoot}/../api/java/util/Collection.html#optional-restrictions">optional</a>) |
523 |
|
*/ |
524 |
|
boolean contains(Object o); |
525 |
|
|