commons-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Gary Gregory (JIRA)" <j...@apache.org>
Subject [jira] [Created] (COLLECTIONS-671) Add org.apache.commons.collections4.IterableUtils.first(Iterable<E>)
Date Wed, 10 Jan 2018 16:57:00 GMT
Gary Gregory created COLLECTIONS-671:
----------------------------------------

             Summary: Add org.apache.commons.collections4.IterableUtils.first(Iterable<E>)
                 Key: COLLECTIONS-671
                 URL: https://issues.apache.org/jira/browse/COLLECTIONS-671
             Project: Commons Collections
          Issue Type: New Feature
          Components: Iterator
            Reporter: Gary Gregory
            Assignee: Gary Gregory
             Fix For: 4.2


Add org.apache.commons.collections4.IterableUtils.first(Iterable<E>):
{code:java}
    /**
     * Returns the <code>first</code> value in the <code>iterable</code>'s
{@link Iterator}, throwing
     * <code>IndexOutOfBoundsException</code> if there is no such element.
     * <p>
     * If the {@link Iterable} is a {@link List}, then it will use {@link List#get(int)}.
     *
     * @param <T> the type of object in the {@link Iterable}.
     * @param iterable  the {@link Iterable} to get a value from, may be null
     * @return the first object
     * @throws IndexOutOfBoundsException if the request  is invalid
     * @since 4.2
     */
    public static <T> T first(final Iterable<T> iterable)
{code}



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)

Mime
View raw message