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-2009 the original author or authors.
015     */
016    package org.fest.assertions;
017    
018    import java.util.*;
019    
020    /**
021     * Understands utility methods related to <code>{@link Collections}</code>.
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</code>. 
031       * @param objects the elements to find in the given <code>Collection</code>.
032       * @return the elements that were not found in the given <code>Collection</code>.
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</code>. 
044       * @param objects the elements to find in the given <code>Collection</code>.
045       * @return the elements that were found in the given <code>Collection</code>.
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    }