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.8 by dholmes, Mon Jul 28 04:11:54 2003 UTC vs.
Revision 1.9 by tim, Mon Jul 28 19:53:49 2003 UTC

#	Line 26 | Line 26 | package java.util;
26		* failure. It is designed for use in collections in which failure to
27		* add is a normal, rather than exceptional occurrence, for example,
28		* in fixed-capacity (or "bounded") queues.
29	<	*
29	>	*
30		* <p>The {@link #remove()} and {@link #poll()} methods remove and
31		* return the head of the queue.
32		* Exactly which element is removed from the queue is a
#	Line 74 | Line 74 | public interface Queue<E> extends Collec
74		* Add the specified element to this queue, if possible.
75		*
76		* @param element the element to add.
77	<	* @return <tt>true</tt> if it was possible to add the element to
77	>	* @return <tt>true</tt> if it was possible to add the element to
78		* this queue.
79		*/
80		boolean offer(E element);
#	Line 83 | Line 83 | public interface Queue<E> extends Collec
83		* Retrieve and remove the head of this queue, if it is available.
84		*
85		* @return the head of this queue, or <tt>null</tt> if this
86	<	*         queue is empty.
86	>	*         queue is empty.
87		*/
88		E poll();
89
90		/**
91	<	* Retrieve and remove the head of this queue.
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
94	<	* queue is empty.
94	>	* queue is empty.
95		*
96		* @return the head of this queue.
97		* @throws NoSuchElementException if this queue is empty.
98		*/
99	<	E remove() throws NoSuchElementException;
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
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
105		* this queue.
106		*
107		* @return the head of this queue, or <tt>null</tt> if this queue is empty.
#	Line 110 | Line 110 | public interface Queue<E> extends Collec
110
111		/**
112		* Retrieve, but do not remove, the head of this queue.  This method
113	<	* differs from the <tt>peek</tt> method only in that it throws an
113	>	* differs from the <tt>peek</tt> method only in that it throws an
114		* exception if this queue is empty.
115		*
116		* @return the head of this queue.
117		* @throws NoSuchElementException if this queue is empty.
118		*/
119	<	E element() throws NoSuchElementException;
119	>	E element();
120		}
121
122

Diff Legend

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