--- jsr166/src/main/java/util/AbstractQueue.java 2003/09/26 11:37:06 1.18 +++ jsr166/src/main/java/util/AbstractQueue.java 2003/10/05 22:59:21 1.19 @@ -101,4 +101,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; + } + }