--- jsr166/src/main/java/util/AbstractQueue.java 2003/09/26 11:37:06 1.18 +++ jsr166/src/main/java/util/AbstractQueue.java 2003/11/10 17:31:18 1.22 @@ -27,6 +27,7 @@ package java.util; * * @since 1.5 * @author Doug Lea + * @param the type of elements held in this collection */ public abstract class AbstractQueue extends AbstractCollection @@ -101,4 +102,43 @@ public abstract class AbstractQueue while (poll() != null) ; } + + /** + * Adds all of the elements in the specified collection to this + * queue. Attempts to addAll of a queue to itself result in + * IllegalArgumentException. Further, the behavior of + * this operation is undefined if the specified collection is + * modified while the operation is in progress. + * + *

This implementation iterates over the specified collection, + * and adds each element returned by the iterator to this + * collection, in turn. A runtime exception encountered while + * trying to add an element (including, in particular, a + * null element) may result in only some of the elements + * having been successfully added when the associated exception is + * thrown. + * + * @param c collection whose elements are to be added to this collection. + * @return true if this collection changed as a result of the + * call. + * @throws NullPointerException if the specified collection or + * any of its elements are null. + * @throws IllegalArgumentException if c is this queue. + * + * @see #add(Object) + */ + public boolean addAll(Collection c) { + if (c == null) + throw new NullPointerException(); + if (c == this) + throw new IllegalArgumentException(); + boolean modified = false; + Iterator e = c.iterator(); + while (e.hasNext()) { + if (add(e.next())) + modified = true; + } + return modified; + } + }