--- jsr166/src/main/java/util/PriorityQueue.java 2003/10/18 12:29:27 1.44
+++ jsr166/src/main/java/util/PriorityQueue.java 2004/06/02 23:45:46 1.50
@@ -1,7 +1,7 @@
/*
* %W% %E%
*
- * Copyright 2003 Sun Microsystems, Inc. All rights reserved.
+ * Copyright 2004 Sun Microsystems, Inc. All rights reserved.
* SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
*/
@@ -32,8 +32,10 @@ package java.util;
* grows automatically. The details of the growth policy are not
* specified.
*
- *
This class implements all of the optional methods of
- * the {@link Collection} and {@link Iterator} interfaces. The
+ *
This class and its iterator implement all of the
+ * optional methods of the {@link Collection} and {@link
+ * Iterator} interfaces.
+ * The
* Iterator provided in method {@link #iterator()} is not
* guaranteed to traverse the elements of the PriorityQueue in any
* particular order. If you need ordered traversal, consider using
@@ -59,10 +61,10 @@ package java.util;
* @since 1.5
* @version %I%, %G%
* @author Josh Bloch
- * @param the base class of all elements held in this collection
+ * @param the type of elements held in this collection
*/
public class PriorityQueue extends AbstractQueue
- implements Queue, java.io.Serializable {
+ implements java.io.Serializable {
private static final long serialVersionUID = -7720805057305804111L;
@@ -199,8 +201,7 @@ public class PriorityQueue extends Ab
public PriorityQueue(Collection extends E> c) {
initializeArray(c);
if (c instanceof SortedSet) {
- // @fixme double-cast workaround for compiler
- SortedSet extends E> s = (SortedSet extends E>) (SortedSet)c;
+ SortedSet extends E> s = (SortedSet extends E>)c;
comparator = (Comparator super E>)s.comparator();
fillFromSorted(s);
} else if (c instanceof PriorityQueue) {
@@ -326,6 +327,10 @@ public class PriorityQueue extends Ab
return offer(o);
}
+ /**
+ * Removes a single instance of the specified element from this
+ * queue, if it is present.
+ */
public boolean remove(Object o) {
if (o == null)
return false;
@@ -457,7 +462,8 @@ public class PriorityQueue extends Ab
}
/**
- * Remove all elements from the priority queue.
+ * Removes all elements from the priority queue.
+ * The queue will be empty after this call returns.
*/
public void clear() {
modCount++;