Java Collection Add addAll(final Collection newItems, final Collection existingItems)

Description

Adds the given items to the given collection

License

Apache License

Parameter

Parameter	Description
T	the type of item in the collection being updated
newItems	the items being added; can be <code>null</code> for none
existingItems	the items being added to; must be modifiable

Exception

Parameter	Description
UnsupportedOperationException	if there are items to add and the existing collection is notmodifiable

Return

true if the existing collection was modified

Declaration

public static <T> boolean addAll(final Collection<? extends T> newItems, final Collection<T> existingItems) 

Method Source Code

//package com.java2s;
/*//from w ww .j a v  a  2s  .  co  m
 * Copyright 2002-2008 the original author or authors.
 *
 * 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.Collection;

public class Main {
    /**
     * Adds the given items to the given collection
     * 
     * @param <T>
     *            the type of item in the collection being updated
     * @param newItems
     *            the items being added; can be <code>null</code> for none
     * @param existingItems
     *            the items being added to; must be modifiable
     * @return <code>true</code> if the existing collection was modified
     * @throws UnsupportedOperationException
     *             if there are items to add and the existing collection is not
     *             modifiable
     * @since 1.2.0
     */
    public static <T> boolean addAll(final Collection<? extends T> newItems, final Collection<T> existingItems) {
        if ((existingItems != null) && (newItems != null)) {
            return existingItems.addAll(newItems);
        }
        return false;
    }
}

Related

1. addAll(Collection t1, Iterable t2)
2. addAll(Collection target, Collection source)
3. addAll(Collection target, Iterable source)
4. addAll(Collection target, S[] source)
5. addAll(final Collection coll, final Object[] array)
6. addAll(final Collection c, final E... array)
7. addAll(final Collection thingsToBeAddedTo, final Collection thingsToAdd)
8. addAll(final Collection coll, final T... objs)
9. addAll(final Collection collection, final T... elements)