23 |
|
* <tr> |
24 |
|
* <td></td> |
25 |
|
* <td ALIGN=CENTER><em>Throws exception</em></td> |
26 |
< |
* <td ALIGN=CENTER><em>Special value</em></td> |
26 |
> |
* <td ALIGN=CENTER><em>Returns special value</em></td> |
27 |
|
* </tr> |
28 |
|
* <tr> |
29 |
|
* <td><b>Insert</b></td> |
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 |