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> |
123 |
|
* @return <tt>true</tt> (as per the spec for {@link Collection#add}) |
124 |
|
* @throws IllegalStateException if the element cannot be added at this |
125 |
|
* time due to capacity restrictions |
126 |
– |
* @throws NullPointerException if the specified element is null and |
127 |
– |
* this queue not permit null elements |
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 |
130 |
|
* @throws IllegalArgumentException if some property of this element |
131 |
|
* prevents it from being added to this queue |
132 |
|
*/ |
135 |
|
/** |
136 |
|
* Inserts the specified element into this queue if it is possible to do |
137 |
|
* so immediately without violating capacity restrictions. |
138 |
< |
* When using a capacity-restricted deque, this method is generally |
138 |
> |
* When using a capacity-restricted queue, this method is generally |
139 |
|
* preferable to {@link #add}, which can fail to insert an element only |
140 |
|
* by throwing an exception. |
141 |
|
* |
142 |
|
* @param e the element to add |
143 |
|
* @return <tt>true</tt> if the element was added to this queue, else |
144 |
|
* <tt>false</tt> |
145 |
– |
* @throws NullPointerException if the specified element is null and |
146 |
– |
* this queue does not permit null elements |
145 |
|
* @throws ClassCastException if the class of the specified element |
146 |
|
* prevents it from being added to this queue |
147 |
+ |
* @throws NullPointerException if the specified element is null and |
148 |
+ |
* this queue does not permit null elements |
149 |
|
* @throws IllegalArgumentException if some property of this element |
150 |
|
* prevents it from being added to this queue |
151 |
|
*/ |