[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.9, Mon Jul 28 19:53:49 2003 UTC revision 1.10, Thu Jul 31 07:18:02 2003 UTC
# Line 18  Line 18 
18   * stacks) which order the elements LIFO (last-in-first-out).   * stacks) which order the elements LIFO (last-in-first-out).
19   * Whatever the ordering used, the <em>head</em> of the queue is that element   * Whatever the ordering used, the <em>head</em> of the queue is that element
20   * which would be removed by a call to {@link #remove() } or {@link #poll()}.   * which would be removed by a call to {@link #remove() } or {@link #poll()}.
21   * Every Queue implementation must specify its ordering guarantees.   * Every <tt>Queue</tt> implementation must specify its ordering guarantees.
22   *   *
23   * <p>The {@link #offer(E)} method adds an element if possible, otherwise   * <p>The {@link #offer(E)} method adds an element if possible, otherwise
24   * returning <tt>false</tt>.  This differs from the {@link   * returning <tt>false</tt>.  This differs from the {@link
# Line 37  Line 37 
37   * while the <tt>poll()</tt> method returns <tt>null</tt>.   * while the <tt>poll()</tt> method returns <tt>null</tt>.
38   *   *
39   * <p>The {@link #element()} and {@link #peek()} methods return, but do   * <p>The {@link #element()} and {@link #peek()} methods return, but do
40   * not delete, the head of the queue.   * not remove, the head of the queue.
41   *   *
42   * <p>The <tt>Queue</tt> interface does not define the <i>blocking queue   * <p>The <tt>Queue</tt> interface does not define the <i>blocking queue
43   * methods</i>, which are common in concurrent programming.  These methods,   * methods</i>, which are common in concurrent programming.  These methods,
# Line 73  Line 73 
73      /**      /**
74       * Add the specified element to this queue, if possible.       * Add the specified element to this queue, if possible.
75       *       *
76       * @param element the element to add.       * @param o the element to add.
77       * @return <tt>true</tt> if it was possible to add the element to       * @return <tt>true</tt> if it was possible to add the element to
78       * this queue.       * this queue, else <tt>false</tt>
79       */       */
80      boolean offer(E element);      boolean offer(E o);
81    
82      /**      /**
83       * Retrieve and remove the head of this queue, if it is available.       * Retrieve and remove the head of this queue, if it is available.
# Line 90  Line 90 
90      /**      /**
91       * Retrieve and remove the head of this queue.       * Retrieve and remove the head of this queue.
92       * This method differs       * This method differs
93       * from the <tt>poll</tt> method in that it throws an exception if the       * from the <tt>poll</tt> method in that it throws an exception if this
94       * queue is empty.       * queue is empty.
95       *       *
96       * @return the head of this queue.       * @return the head of this queue.
# Line 99  Line 99 
99      E remove();      E remove();
100    
101      /**      /**
102       * Retrieve, but do not remove, the head of this queue, or <tt>null</tt>       * Retrieve, but do not remove, the head of this queue.
103       * if this queue is empty.  This method differs from the <tt>poll</tt>       * This method differs from the <tt>poll</tt>
104       * method only in that this method does not remove the element from       * method only in that this method does not remove the head element from
105       * this queue.       * this queue.
106       *       *
107       * @return the head of this queue, or <tt>null</tt> if this queue is empty.       * @return the head of this queue, or <tt>null</tt> if this queue is empty.

Legend:
Removed from v.1.9  
changed lines
  Added in v.1.10

Doug Lea
ViewVC Help
Powered by ViewVC 1.0.8