Java Iterable Item getFirst(final Iterable iterable)

Description

Retrieves the first element of an Iterable

License

Open Source License

Parameter

Parameter	Description
iterable	the Iterable
E	the element type

Return

the first element

Declaration

public final static <E> E getFirst(final Iterable<E> iterable) 

Method Source Code

//package com.java2s;
/**/*from www  . j  a va2s. c om*/
 * The contents of this file are subject to the Regenstrief Public License
 * Version 1.0 (the "License"); you may not use this file except in compliance with the License.
 * Please contact Regenstrief Institute if you would like to obtain a copy of the license.
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
 * License for the specific language governing rights and limitations
 * under the License.
 *
 * Copyright (C) Regenstrief Institute.  All Rights Reserved.
 */

import java.util.*;

public class Main {
    /**
     * Retrieves the first element of an Iterable
     * 
     * @param iterable the Iterable
     * @param <E> the element type
     * @return the first element
     **/
    public final static <E> E getFirst(final Iterable<E> iterable) {
        final Iterator<E> iter = iterator(iterable);
        return hasNext(iter) ? iter.next() : null;
    }

    public final static <E> Iterator<E> iterator(final Iterable<E> iterable) {
        return iterable == null ? null : iterable.iterator();
    }

    public final static boolean hasNext(final Iterator<?> i) {
        return (i != null) && i.hasNext();
    }
}

Related

1. clear(Iterable iterable)
2. concat(final Iterable> iterables)
3. concat(Iterable... iterables)
4. concat(Iterable first, Iterable second)
5. contains(Iterable iter, Object o)
6. getFirst(Iterable iterable)
7. getFirstElement(Object maybeIterable)
8. getFrom(Iterable iterable, int index)
9. isIterable(Object obj)