ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/jsr166/jsr166/src/main/java/util/Queue.java
(Generate patch)

Comparing jsr166/src/main/java/util/Queue.java (file contents):
Revision 1.29 by jsr166, Sat May 14 02:11:52 2005 UTC vs.
Revision 1.36 by jsr166, Tue Mar 15 19:47:03 2011 UTC

# Line 1 | Line 1
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;
# Line 23 | Line 23 | package java.util;
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>
# Line 97 | Line 97 | package java.util;
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
# Line 120 | Line 120 | public interface Queue<E> extends Collec
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 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 does not permit null elements
130       * @throws IllegalArgumentException if some property of this element
131       *         prevents it from being added to this queue
132       */
# Line 135 | Line 135 | public interface Queue<E> extends Collec
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       */
# Line 153 | Line 153 | public interface Queue<E> extends Collec
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
# Line 171 | Line 171 | public interface Queue<E> extends Collec
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

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines