001    /*
002     * Created on Mar 31, 2008
003     *
004     * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
005     * in compliance with the License. You may obtain a copy of the License at
006     *
007     * http://www.apache.org/licenses/LICENSE-2.0
008     *
009     * Unless required by applicable law or agreed to in writing, software distributed under the License
010     * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
011     * or implied. See the License for the specific language governing permissions and limitations under
012     * the License.
013     *
014     * Copyright @2008-2011 the original author or authors.
015     */
016    package org.fest.assertions;
017    
018    import java.util.*;
019    
020    /**
021     * Utility methods for <code>{@link Collection}</code>s.
022     *
023     * @author Alex Ruiz
024     */
025    public final class Collections {
026    
027      /**
028       * Attempts to find the given objects in the given <code>{@link Collection}</code>, returning the ones that were not
029       * found.
030       * @param target the given {@code Collection}.
031       * @param objects the elements to find in the given {@code Collection}.
032       * @return the elements that were not found in the given {@code Collection}.
033       */
034      public static Collection<Object> notFound(Collection<?> target, Object...objects) {
035        List<Object> notFound = new ArrayList<Object>();
036        for (Object o : objects) if (!target.contains(o)) notFound.add(o);
037        return notFound;
038      }
039    
040      /**
041       * Attempts to find the given objects in the given <code>{@link Collection}</code>, returning the ones that were
042       * found.
043       * @param target the given {@code Collection}.
044       * @param objects the elements to find in the given {@code Collection}.
045       * @return the elements that were found in the given {@code Collection}.
046       */
047      public static Collection<Object> found(Collection<?> target, Object...objects) {
048        List<Object> found = new ArrayList<Object>();
049        for (Object o : objects) if (target.contains(o)) found.add(o);
050        return found;
051      }
052    
053      private Collections() {}
054    }