| 1 |
|
/* |
| 2 |
|
* Written by Doug Lea with assistance from members of JCP JSR-166 |
| 3 |
|
* Expert Group and released to the public domain, as explained at |
| 4 |
< |
* http://creativecommons.org/licenses/publicdomain |
| 4 |
> |
* http://creativecommons.org/publicdomain/zero/1.0/ |
| 5 |
|
*/ |
| 6 |
|
|
| 7 |
|
package java.util; |
| 50 |
|
* Whatever the ordering used, the <em>head</em> of the queue is that |
| 51 |
|
* element which would be removed by a call to {@link #remove() } or |
| 52 |
|
* {@link #poll()}. In a FIFO queue, all new elements are inserted at |
| 53 |
< |
* the <em> tail</em> of the queue. Other kinds of queues may use |
| 53 |
> |
* the <em>tail</em> of the queue. Other kinds of queues may use |
| 54 |
|
* different placement rules. Every <tt>Queue</tt> implementation |
| 55 |
|
* must specify its ordering properties. |
| 56 |
|
* |
| 97 |
|
* |
| 98 |
|
* |
| 99 |
|
* <p>This interface is a member of the |
| 100 |
< |
* <a href="{@docRoot}/../guide/collections/index.html"> |
| 100 |
> |
* <a href="{@docRoot}/../technotes/guides/collections/index.html"> |
| 101 |
|
* Java Collections Framework</a>. |
| 102 |
|
* |
| 103 |
|
* @see java.util.Collection |
| 120 |
|
* if no space is currently available. |
| 121 |
|
* |
| 122 |
|
* @param e the element to add |
| 123 |
< |
* @return <tt>true</tt> (as per the spec for {@link Collection#add}) |
| 123 |
> |
* @return <tt>true</tt> (as specified by {@link Collection#add}) |
| 124 |
|
* @throws IllegalStateException if the element cannot be added at this |
| 125 |
|
* time due to capacity restrictions |
| 126 |
|
* @throws ClassCastException if the class of the specified element |
| 127 |
|
* prevents it from being added to this queue |
| 128 |
|
* @throws NullPointerException if the specified element is null and |
| 129 |
< |
* this queue not permit null elements |
| 129 |
> |
* this queue does not permit null elements |
| 130 |
|
* @throws IllegalArgumentException if some property of this element |
| 131 |
|
* prevents it from being added to this queue |
| 132 |
|
*/ |
| 153 |
|
|
| 154 |
|
/** |
| 155 |
|
* Retrieves and removes the head of this queue. This method differs |
| 156 |
< |
* from {@link #poll} only in that it throws an exception if this queue |
| 157 |
< |
* is empty. |
| 156 |
> |
* from {@link #poll poll} only in that it throws an exception if this |
| 157 |
> |
* queue is empty. |
| 158 |
|
* |
| 159 |
|
* @return the head of this queue |
| 160 |
|
* @throws NoSuchElementException if this queue is empty |
| 171 |
|
|
| 172 |
|
/** |
| 173 |
|
* Retrieves, but does not remove, the head of this queue. This method |
| 174 |
< |
* differs from {@link #peek} only in that it throws an exception if |
| 175 |
< |
* this queue is empty. |
| 174 |
> |
* differs from {@link #peek peek} only in that it throws an exception |
| 175 |
> |
* if this queue is empty. |
| 176 |
|
* |
| 177 |
|
* @return the head of this queue |
| 178 |
|
* @throws NoSuchElementException if this queue is empty |
