26 |
|
* subclassing {@link AbstractCollection}. |
27 |
|
* |
28 |
|
* <p>This class is a member of the |
29 |
< |
* <a href="{@docRoot}/../guide/collections/index.html"> |
29 |
> |
* <a href="{@docRoot}/../technotes/guides/collections/index.html"> |
30 |
|
* Java Collections Framework</a>. |
31 |
|
* |
32 |
|
* @since 1.5 |
53 |
|
* else throws an <tt>IllegalStateException</tt>. |
54 |
|
* |
55 |
|
* @param e the element to add |
56 |
< |
* @return <tt>true</tt> (as per the spec for {@link Collection#add}) |
56 |
> |
* @return <tt>true</tt> (as specified by {@link Collection#add}) |
57 |
|
* @throws IllegalStateException if the element cannot be added at this |
58 |
|
* time due to capacity restrictions |
59 |
|
* @throws ClassCastException if the class of the specified element |
60 |
|
* prevents it from being added to this queue |
61 |
|
* @throws NullPointerException if the specified element is null and |
62 |
< |
* this queue not permit null elements |
62 |
> |
* this queue does not permit null elements |
63 |
|
* @throws IllegalArgumentException if some property of this element |
64 |
|
* prevents it from being added to this queue |
65 |
|
*/ |
72 |
|
|
73 |
|
/** |
74 |
|
* Retrieves and removes the head of this queue. This method differs |
75 |
< |
* from {@link #poll} only in that it throws an exception if this queue |
76 |
< |
* is empty. |
75 |
> |
* from {@link #poll poll} only in that it throws an exception if this |
76 |
> |
* queue is empty. |
77 |
|
* |
78 |
|
* <p>This implementation returns the result of <tt>poll</tt> |
79 |
|
* unless the queue is empty. |
91 |
|
|
92 |
|
/** |
93 |
|
* Retrieves, but does not remove, the head of this queue. This method |
94 |
< |
* differs from {@link #peek} only in that it throws an exception if |
94 |
> |
* differs from {@link #peek peek} only in that it throws an exception if |
95 |
|
* this queue is empty. |
96 |
|
* |
97 |
|
* <p>This implementation returns the result of <tt>peek</tt> |
135 |
|
* having been successfully added when the associated exception is |
136 |
|
* thrown. |
137 |
|
* |
138 |
< |
* @param c collection whose elements are to be added to this queue |
138 |
> |
* @param c collection containing elements to be added to this queue |
139 |
|
* @return <tt>true</tt> if this queue changed as a result of the call |
140 |
|
* @throws ClassCastException if the class of an element of the specified |
141 |
|
* collection prevents it from being added to this queue |