ViewVC Help

View File | Revision Log | Show Annotations | Download File | Root Listing

root/jsr166/jsr166/src/main/java/util/Queue.java

Comparing jsr166/src/main/java/util/Queue.java (file contents):
Revision 1.9 by tim, Mon Jul 28 19:53:49 2003 UTC vs.
Revision 1.10 by dholmes, Thu Jul 31 07:18:02 2003 UTC

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

Diff Legend

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