org.salespointframework.util

Class Iterables

java.lang.Object

org.salespointframework.util.Iterables

public final class Iterables
extends java.lang.Object

Utility class for working with Iterables

Author:

Paul Henke

Method Summary

Methods

Modifier and Type	Method and Description
static <T> T[]	asArray(java.lang.Iterable<T> iterable) Converts an Iterable to an Array
static <T> java.util.List<T>	asList(java.lang.Iterable<T> iterable) Converts an Iterable to a List
static <T> java.util.Set<T>	asSet(java.lang.Iterable<T> iterable) Converts an Iterable to a Set
static <T> java.lang.Iterable<T>	empty() Creates a new empty Iterable of T
static <T> T	first(java.lang.Iterable<T> iterable) Returns the first element of an Iterable
static <T> boolean	isEmpty(java.lang.Iterable<T> iterable) Checks if an Iterable is empty
static <T> java.lang.Iterable<T>	of(java.lang.Iterable<T> iterable) Returns a lazy Iterable from another Iterable.
static <T> java.lang.Iterable<T>	of(T[] array) Returns a lazy Iterable from an Array.
static <T> int	size(java.lang.Iterable<T> iterable) Calculates the length/size of an Iterable

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

asList

public static <T> java.util.List<T> asList(java.lang.Iterable<T> iterable)

Converts an Iterable to a List

Parameters:

iterable - an Iterable

Returns:

a List

Throws:

java.lang.NullPointerException - if iterable is null

asSet

public static <T> java.util.Set<T> asSet(java.lang.Iterable<T> iterable)

Converts an Iterable to a Set

Parameters:

iterable - an Iterable

Returns:

a Set

Throws:

java.lang.NullPointerException - if iterable is null

asArray

public static <T> T[] asArray(java.lang.Iterable<T> iterable)

Converts an Iterable to an Array

Parameters:

iterable - an Iterable

Returns:

an Array

Throws:

java.lang.NullPointerException - if iterable is null

isEmpty

public static <T> boolean isEmpty(java.lang.Iterable<T> iterable)

Checks if an Iterable is empty

Parameters:

iterable - an Iterable

Returns:

true if iterable is empty, otherwise false

Throws:

java.lang.NullPointerException - if iterable is null

empty

public static <T> java.lang.Iterable<T> empty()

Creates a new empty Iterable of T

Returns:

an empty Iterable

size

public static <T> int size(java.lang.Iterable<T> iterable)

Calculates the length/size of an Iterable

Parameters:

iterable - an Iterable

Returns:

the number of elements in iterable

Throws:

java.lang.NullPointerException - if iterable is null

first

public static <T> T first(java.lang.Iterable<T> iterable)

Returns the first element of an Iterable

Parameters:

iterable -

Returns:

the first element, if iterable is empty, null is returned

Throws:

java.lang.NullPointerException - if iterable is null

of

public static <T> java.lang.Iterable<T> of(java.lang.Iterable<T> iterable)

Returns a lazy Iterable from another Iterable. Iterator.remove() throws an UnsupportedOperationException.

Parameters:

iterable - an Iterable

Returns:

a new Iterable

Throws:

java.lang.NullPointerException - if iterable is null

of

public static <T> java.lang.Iterable<T> of(T[] array)

Returns a lazy Iterable from an Array. Iterator.remove() throws an UnsupportedOperationException.

Parameters:

array - an Array

Returns:

a new Iterable

Throws:

java.lang.NullPointerException - if array is null