All Downloads are FREE. Search and download functionalities are using the official Maven repository.
  • Log In
  • Register

    • com.github.basking2.sdsai.itrex.iterators.Iterators Maven / Gradle / Ivy

    There is a newer version: 1.1.23
    Show newest version
    package com.github.basking2.sdsai.itrex.iterators;

import java.util.Arrays;
import java.util.Iterator;
import java.util.NoSuchElementException;
import java.util.List;
import java.util.ArrayList;

public class Iterators {

    public static Iterator EMPTY_ITERATOR = new Iterator() {

        @Override
        public boolean hasNext() {
            return false;
        }

        @Override
        public Object next() {
            throw new NoSuchElementException("Next called on the empty iterator.");
        }
    };

    /**
     * Map iterables and arrays to iterators or returns null.
     *
     * If an iterator is passed it, it is returned.
     *
     * This will not wrap a non-iterable object (or array) into a single element iterator. See {@link #wrap(Object[])} for that.
     *
     * @param o An object we would like to try and convert to an {@link Iterator}.
     * @param  The type returned by the {@link Iterator}.
     * @return An iterator that walks over the elements in o, or null if we cannot convert o to an {@link Iterator}.
     */
    @SuppressWarnings("unchecked")
    public static  Iterator toIterator(final Object o) {
        if (o instanceof Iterator) {
            return ((Iterator)o);
        }

        if (o instanceof Iterable) {
            return ((Iterable)o).iterator();
        }

        if (o instanceof Object[]) {
            return Arrays.asList((T[])o).iterator();
        }

        return null;
    }

    /**
     * Wrap one or more values into an iterator.
     *
     * @param ts The t values to wrap into an interator.
     *
     * @param  The type returned by the returned iterator.
     * @return An interator that will walk through ts values.
     */
    @SafeVarargs
    public static  Iterator wrap(final T ... ts) {
        return new Iterator() {

            int idx = 0;

            @Override
            public boolean hasNext() {
                return idx < ts.length;
            }

            @Override
            public T next() {
                try {
                    return ts[idx++];
                } catch (final ArrayIndexOutOfBoundsException e) {
                    throw new NoSuchElementException(e.getMessage());
                }
            }
        };
    }

    /**
     * Construct and return a {@link NullSkippingIterator}.
     *
     * @param iterator The iterator.
     * @param  A type for iterator.
     * @return A {@link NullSkippingIterator}.
     */
    public static  Iterator skipNulls(final Iterator iterator) {
        return new NullSkippingIterator(iterator);
    }

    /**
     * Construct and return a {@link MappingIterator}.
     *
     * @param iterator The iterator that provides the input T values.
     * @param f The mapping function.
     * @param  The input type.
     * @param  The output type.
     * @return a {@link MappingIterator}.
     */
    public static  MappingIterator mapIterator(final Iterator iterator, final MappingIterator.Mapper f) {
        return new MappingIterator(iterator, f);
    }

    /**
     * Collect the elements of an iterator into a {@link List}.
     *
     * @param itr The iterator to materialize.
     * @param  The type of list elements.
     * @return a list for the iterator.
     */
    public static  List toList(final Iterator itr) {
        final ArrayList list = new ArrayList();
        while (itr.hasNext()) {
            list.add(itr.next());
        }
        return list;
    }
}
    
    
    
    

    




    
    
    © 2015 - 2024 Weber Informatics LLC | Privacy Policy