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 |