[cvs] / jsr166 / src / main / java / util / Queue.java Repository:
ViewVC logotype

Diff of /jsr166/src/main/java/util/Queue.java

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.29, Sat May 14 02:11:52 2005 UTC revision 1.34, Fri Mar 3 17:18:16 2006 UTC
# Line 23  Line 23 
23   *  <tr>   *  <tr>
24   *    <td></td>   *    <td></td>
25   *    <td ALIGN=CENTER><em>Throws exception</em></td>   *    <td ALIGN=CENTER><em>Throws exception</em></td>
26   *    <td ALIGN=CENTER><em>Special value</em></td>   *    <td ALIGN=CENTER><em>Returns special value</em></td>
27   *  </tr>   *  </tr>
28   *  <tr>   *  <tr>
29   *    <td><b>Insert</b></td>   *    <td><b>Insert</b></td>
# Line 120  Line 120 
120       * if no space is currently available.       * if no space is currently available.
121       *       *
122       * @param e the element to add       * @param e the element to add
123       * @return <tt>true</tt> (as per the spec for {@link Collection#add})       * @return <tt>true</tt> (as specified by {@link Collection#add})
124       * @throws IllegalStateException if the element cannot be added at this       * @throws IllegalStateException if the element cannot be added at this
125       *         time due to capacity restrictions       *         time due to capacity restrictions
      * @throws NullPointerException if the specified element is null and  
      *         this queue not permit null elements  
126       * @throws ClassCastException if the class of the specified element       * @throws ClassCastException if the class of the specified element
127       *         prevents it from being added to this queue       *         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       * @throws IllegalArgumentException if some property of this element
131       *         prevents it from being added to this queue       *         prevents it from being added to this queue
132       */       */
# Line 135  Line 135 
135      /**      /**
136       * Inserts the specified element into this queue if it is possible to do       * Inserts the specified element into this queue if it is possible to do
137       * so immediately without violating capacity restrictions.       * so immediately without violating capacity restrictions.
138       * When using a capacity-restricted deque, this method is generally       * When using a capacity-restricted queue, this method is generally
139       * preferable to {@link #add}, which can fail to insert an element only       * preferable to {@link #add}, which can fail to insert an element only
140       * by throwing an exception.       * by throwing an exception.
141       *       *
142       * @param e the element to add       * @param e the element to add
143       * @return <tt>true</tt> if the element was added to this queue, else       * @return <tt>true</tt> if the element was added to this queue, else
144       *         <tt>false</tt>       *         <tt>false</tt>
      * @throws NullPointerException if the specified element is null and  
      *         this queue does not permit null elements  
145       * @throws ClassCastException if the class of the specified element       * @throws ClassCastException if the class of the specified element
146       *         prevents it from being added to this queue       *         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       * @throws IllegalArgumentException if some property of this element
150       *         prevents it from being added to this queue       *         prevents it from being added to this queue
151       */       */
# Line 153  Line 153 
153    
154      /**      /**
155       * Retrieves and removes the head of this queue.  This method differs       * 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       * from {@link #poll poll} only in that it throws an exception if this
157       * is empty.       * queue is empty.
158       *       *
159       * @return the head of this queue       * @return the head of this queue
160       * @throws NoSuchElementException if this queue is empty       * @throws NoSuchElementException if this queue is empty
# Line 171  Line 171 
171    
172      /**      /**
173       * Retrieves, but does not remove, the head of this queue.  This method       * 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       * differs from {@link #peek peek} only in that it throws an exception
175       * this queue is empty.       * if this queue is empty.
176       *       *
177       * @return the head of this queue       * @return the head of this queue
178       * @throws NoSuchElementException if this queue is empty       * @throws NoSuchElementException if this queue is empty

Legend:
Removed from v.1.29  
changed lines
  Added in v.1.34

Doug Lea
ViewVC Help
Powered by ViewVC 1.0.8