[COLLECTIONS-671] Add org.apache.commons.collections4.IterableUtils.first(Iterable<E>)

• Type: New Feature
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 4.2
• Component/s: Iterator
• Assignee: Gary D. Gregory
• Reporter: Gary D. Gregory
• Created: 10/Jan/18 16:56
• Updated: 10/Jan/18 16:57
• Resolved: 10/Jan/18 16:57

Description

Add org.apache.commons.collections4.IterableUtils.first(Iterable<E>):

    /**
     * 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)