Package org.hamcrest.collection

Class IsEmptyIterable<E>

java.lang.Object

org.hamcrest.BaseMatcher<Iterable<? extends E>>

org.hamcrest.TypeSafeMatcher<Iterable<? extends E>>

org.hamcrest.collection.IsEmptyIterable<E>

Type Parameters:

E - the iterable element type

All Implemented Interfaces:

Matcher<Iterable<? extends E>>, SelfDescribing

public class IsEmptyIterable<E>
extends TypeSafeMatcher<Iterable<? extends E>>

Tests if an iterable is empty.

Constructor Summary

Constructors

Constructor	Description
IsEmptyIterable()	Constructor, best called from emptyIterable() or emptyIterableOf(Class).

Method Summary

Modifier and Type	Method	Description
void	describeMismatchSafely(Iterable<? extends E> iter, Description mismatchDescription)	Describe the mismatch.
void	describeTo(Description description)	Generates a description of the object.
static <E> Matcher<Iterable<? extends E>>	emptyIterable()	Creates a matcher for Iterables matching examined iterables that yield no items.
static <E> Matcher<Iterable<E>>	emptyIterableOf(Class<E> unusedToForceReturnType)	Creates a matcher for Iterables matching examined iterables that yield no items.
boolean	matchesSafely(Iterable<? extends E> iterable)	Check if the item matches.

Methods inherited from class org.hamcrest.TypeSafeMatcher

describeMismatch, matches

Methods inherited from class org.hamcrest.BaseMatcher

_dont_implement_Matcher___instead_extend_BaseMatcher_, isNotNull, toString

Methods inherited from class java.lang.Object

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

Constructor Details

IsEmptyIterable

public IsEmptyIterable()

Constructor, best called from emptyIterable() or emptyIterableOf(Class).

Method Details

matchesSafely

public boolean matchesSafely(Iterable<? extends E> iterable)

Description copied from class: TypeSafeMatcher

Check if the item matches. The item will already have been checked for the specific type and will never be null. Subclasses should implement this.

Specified by:

matchesSafely in class TypeSafeMatcher<Iterable<? extends E>>

Parameters:

iterable - the type safe item to match against.

Returns:

boolean true/false depending if item matches matcher.

describeMismatchSafely

public void describeMismatchSafely(Iterable<? extends E> iter,
 Description mismatchDescription)

Description copied from class: TypeSafeMatcher

Describe the mismatch. The item will already have been checked for the specific type and will never be null. Subclasses should override this.

Overrides:

describeMismatchSafely in class TypeSafeMatcher<Iterable<? extends E>>

Parameters:

iter - the type safe item to match against.

mismatchDescription - the mismatch description.

describeTo

public void describeTo(Description description)

Description copied from interface: SelfDescribing

Generates a description of the object. The description may be part of a description of a larger object of which this is just a component, so it should be worded appropriately.

Parameters:

description - The description to be built or appended to.

emptyIterable

public static <E> Matcher<Iterable<? extends E>> emptyIterable()

Creates a matcher for Iterables matching examined iterables that yield no items. For example:

assertThat(new ArrayList<String>(), is(emptyIterable()))

Type Parameters:

E - the matcher type.

Returns:

The matcher.

emptyIterableOf

public static <E> Matcher<Iterable<E>> emptyIterableOf(Class<E> unusedToForceReturnType)

Creates a matcher for Iterables matching examined iterables that yield no items. For example:

assertThat(new ArrayList<String>(), is(emptyIterableOf(String.class)))

Type Parameters:

E - the matcher type.

Parameters:

unusedToForceReturnType - the type of the iterable's content

Returns:

The matcher.