Java Collection Add addAll(Collection collection, Iterator iterator)

Description

Adds all elements in the iteration to the given collection.

License

Apache License

Parameter

Parameter	Description
collection	the collection to add to
iterator	the iterator of elements to add, may not be null

Exception

Parameter	Description
NullPointerException	if the collection or iterator is null

Declaration

public static <E> void addAll(Collection<E> collection,
        Iterator<? extends E> iterator) 

Method Source Code

//package com.java2s;
/*/*from w  ww  .  java2s  . c om*/
 *  Copyright 2001-2004 The Apache Software Foundation
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 */

import java.util.*;

public class Main {
    /**
     * Adds all elements in the iteration to the given collection.
     * @deprecated Replaced by {@link Collection#addAll(java.util.Collection<? extends E>)}
     *
     * @param collection the collection to add to
     * @param iterator   the iterator of elements to add, may not be null
     * @throws NullPointerException if the collection or iterator is null
     */
    public static <E> void addAll(Collection<E> collection,
            Iterator<? extends E> iterator) {
        while (iterator.hasNext()) {
            collection.add(iterator.next());
        }
    }

    /**
     * Adds all elements in the enumeration to the given collection.
     * @deprecated Replaced by {@link Collection#addAll(java.util.Collection<? extends E>)}
     *
     * @param collection  the collection to add to
     * @param enumeration the enumeration of elements to add, may not be null
     * @throws NullPointerException if the collection or enumeration is null
     */
    public static <E> void addAll(Collection<E> collection,
            Enumeration<? extends E> enumeration) {
        while (enumeration.hasMoreElements()) {
            collection.add(enumeration.nextElement());
        }
    }

    /**
     * Adds all elements in the array to the given collection.
     *
     * @param collection the collection to add to, may not be null
     * @param elements   the array of elements to add, may not be null
     * @throws NullPointerException if the collection or array is null
     */
    public static <E, T extends E> void addAll(Collection<E> collection,
            T... elements) {
        for (int i = 0, size = elements.length; i < size; i++) {
            collection.add(elements[i]);
        }
    }
}

Related

1. addAll(Collection c, T... array)
2. addAll(Collection c, T... array)
3. addAll(Collection coll, Iterable it)
4. addAll(Collection collection, E... args)
5. addAll(Collection collection, Iterable iterable)
6. addAll(Collection pCollection, Iterator pIterator)
7. addAll(Collection integerCollection, int[] intArray)
8. addAll(Collection c, T[] a)
9. addAll(Collection col, T[] arr)