[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.32, Mon Jul 18 01:04:11 2005 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 123  Line 123 
123       * @return <tt>true</tt> (as per the spec for {@link Collection#add})       * @return <tt>true</tt> (as per the spec for {@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 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       */       */

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

Doug Lea
ViewVC Help
Powered by ViewVC 1.0.8