org.assertj.core.util

Class IterableUtil

java.lang.Object

org.assertj.core.util.GroupFormatUtil

org.assertj.core.util.IterableUtil

public final class IterableUtil
extends GroupFormatUtil

Field Summary

Fields inherited from class org.assertj.core.util.GroupFormatUtil

DEFAULT_END, DEFAULT_START, ELEMENT_SEPARATOR, ELEMENT_SEPARATOR_WITH_NEWLINE, INDENTATION_AFTER_NEWLINE, INDENTATION_FOR_SINGLE_LINE, maxLengthForSingleLineDescription

Constructor Summary

Constructors

Modifier	Constructor and Description
private	IterableUtil()

Method Summary

Modifier and Type	Method and Description
private static boolean	doesDescriptionFitOnSingleLine(java.lang.String singleLineDescription)
private static java.lang.String	format(Representation representation, java.lang.Iterable<?> iterable, java.lang.String start, java.lang.String end, java.lang.String elementSeparator, java.lang.String indentation)
static boolean	isNullOrEmpty(java.lang.Iterable<?> iterable) Indicates whether the given Iterable is null or empty.
static java.lang.String	multiLineFormat(Representation representation, java.lang.Iterable<?> iterable)
private static <T> T[]	newArray(java.lang.Class<T> type, int length)
static <T> java.util.List<T>	nonNullElementsIn(java.lang.Iterable<? extends T> i) Returns all the non-null elements in the given Iterable.
static java.lang.String	singleLineFormat(Representation representation, java.lang.Iterable<?> iterable, java.lang.String start, java.lang.String end)
static int	sizeOf(java.lang.Iterable<?> iterable) Returns the size of the given Iterable.
static java.lang.String	smartFormat(Representation representation, java.lang.Iterable<?> iterable) Returns the String representation of the given Iterable, or null if the given Iterable is null.
static <T> T[]	toArray(java.lang.Iterable<? extends T> iterable) Create an array from an Iterable.
static <T> T[]	toArray(java.lang.Iterable<? extends T> iterable, java.lang.Class<T> type) Create an typed array from an Iterable.
private static <T> java.util.Collection<T>	toCollection(java.lang.Iterable<T> iterable)

Methods inherited from class org.assertj.core.util.GroupFormatUtil

setMaxLengthForSingleLineDescription

Methods inherited from class java.lang.Object

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

Constructor Detail

IterableUtil

private IterableUtil()

Method Detail

isNullOrEmpty

public static boolean isNullOrEmpty(java.lang.Iterable<?> iterable)

Indicates whether the given Iterable is null or empty.

Parameters:

iterable - the given Iterable to check.

Returns:

true if the given Iterable is null or empty, otherwise false.

sizeOf

public static int sizeOf(java.lang.Iterable<?> iterable)

Returns the size of the given Iterable.

Parameters:

iterable - the Iterable to get size.

Returns:

the size of the given Iterable.

Throws:

java.lang.NullPointerException - if given Iterable is null.

nonNullElementsIn

public static <T> java.util.List<T> nonNullElementsIn(java.lang.Iterable<? extends T> i)

Returns all the non-null elements in the given Iterable.

Type Parameters:

T - the type of elements of the Iterable.

Parameters:

i - the given Iterable.

Returns:

all the non-null elements in the given Iterable. An empty list is returned if the given Iterable is null.

Since:

1.1.3

toArray

public static <T> T[] toArray(java.lang.Iterable<? extends T> iterable)

Create an array from an Iterable.

Note: this method will return Object[]. If you require a typed array please use toArray(Iterable, Class). It's main usage is to keep the generic type for chaining call like in:

 public S containsOnlyElementsOf(Iterable iterable) {
   return containsOnly(toArray(iterable));
 }

Type Parameters:

T - the type of elements of the Iterable.

Parameters:

iterable - an Iterable to translate in an array.

Returns:

all the elements from the given Iterable in an array. null if given Iterable is null.

toArray

public static <T> T[] toArray(java.lang.Iterable<? extends T> iterable,
                              java.lang.Class<T> type)

Create an typed array from an Iterable.

Type Parameters:

T - the type of elements of the Iterable.

Parameters:

iterable - an Iterable to translate in an array.

type - the type of the resulting array.

Returns:

all the elements from the given Iterable in an array. null if given Iterable is null.

toCollection

private static <T> java.util.Collection<T> toCollection(java.lang.Iterable<T> iterable)

newArray

private static <T> T[] newArray(java.lang.Class<T> type,
                                int length)

smartFormat

public static java.lang.String smartFormat(Representation representation,
                                           java.lang.Iterable<?> iterable)

Returns the String representation of the given Iterable, or null if the given Iterable is null.

The Iterable will be formatted to a single line if it does not exceed 100 char, otherwise each elements will be formatted on a new line with 4 space indentation.

Parameters:

representation -

iterable - the Iterable to format.

Returns:

the String representation of the given Iterable.

singleLineFormat

public static java.lang.String singleLineFormat(Representation representation,
                                                java.lang.Iterable<?> iterable,
                                                java.lang.String start,
                                                java.lang.String end)

multiLineFormat

public static java.lang.String multiLineFormat(Representation representation,
                                               java.lang.Iterable<?> iterable)

doesDescriptionFitOnSingleLine

private static boolean doesDescriptionFitOnSingleLine(java.lang.String singleLineDescription)

format

private static java.lang.String format(Representation representation,
                                       java.lang.Iterable<?> iterable,
                                       java.lang.String start,
                                       java.lang.String end,
                                       java.lang.String elementSeparator,
                                       java.lang.String indentation)