org.carrot2.util.CollectionUtils Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of carrot2-core Show documentation

Carrot2 Text Clustering Library

There is a newer version: 4.6.0


/*
 * Carrot2 project.
 *
 * Copyright (C) 2002-2018, Dawid Weiss, Stanisław Osiński.
 * All rights reserved.
 *
 * Refer to the full license file "carrot2.LICENSE"
 * in the root folder of the repository checkout or at:
 * http://www.carrot2.org/carrot2.LICENSE
 */

package org.carrot2.util;

import java.util.Collection;

/**
 * A number of utility classes for working with {@link Collection}s.
 */
public final class CollectionUtils
{
    private CollectionUtils()
    {
        // No instantiation
    }

    /**
     * Returns the first element from the provided collection.
     * 
     * @param collection the collection to get the element from
     * @return first element from the provided collection or null if the
     *         collection is null or empty.
     */
    public static  T getFirst(Collection collection)
    {
        if (collection == null || collection.isEmpty())
        {
            return null;
        }

        return collection.iterator().next();
    }
}