org.hamcrest.collection
Class IsEmptyIterable<E>

java.lang.Object
  extended by org.hamcrest.BaseMatcher<T>
      extended by org.hamcrest.TypeSafeMatcher<java.lang.Iterable<? extends E>>
          extended by org.hamcrest.collection.IsEmptyIterable<E>
All Implemented Interfaces:
Matcher<java.lang.Iterable<? extends E>>, SelfDescribing

public class IsEmptyIterable<E>
extends TypeSafeMatcher<java.lang.Iterable<? extends E>>

Tests if collection is empty.


Constructor Summary
IsEmptyIterable()
           
 
Method Summary
 void describeMismatchSafely(java.lang.Iterable<? extends E> iter, Description mismatchDescription)
          Subclasses should override this.
 void describeTo(Description description)
          Generates a description of the object.
static
<E> Matcher<java.lang.Iterable<? extends E>>
emptyIterable()
          Creates a matcher for Iterables matching examined iterables that yield no items.
static
<E> Matcher<java.lang.Iterable<E>>
emptyIterableOf(java.lang.Class<E> type)
          Creates a matcher for Iterables matching examined iterables that yield no items.
 boolean matchesSafely(java.lang.Iterable<? extends E> iterable)
          Subclasses should implement this.
 
Methods inherited from class org.hamcrest.TypeSafeMatcher
describeMismatch, matches
 
Methods inherited from class org.hamcrest.BaseMatcher
_dont_implement_Matcher___instead_extend_BaseMatcher_, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

IsEmptyIterable

public IsEmptyIterable()
Method Detail

matchesSafely

public boolean matchesSafely(java.lang.Iterable<? extends E> iterable)
Description copied from class: TypeSafeMatcher
Subclasses should implement this. The item will already have been checked for the specific type and will never be null.

Specified by:
matchesSafely in class TypeSafeMatcher<java.lang.Iterable<? extends E>>

describeMismatchSafely

public void describeMismatchSafely(java.lang.Iterable<? extends E> iter,
                                   Description mismatchDescription)
Description copied from class: TypeSafeMatcher
Subclasses should override this. The item will already have been checked for the specific type and will never be null.

Overrides:
describeMismatchSafely in class TypeSafeMatcher<java.lang.Iterable<? extends E>>

describeTo

public void describeTo(Description description)
Description copied from interface: SelfDescribing
Generates a description of the object. The description may be part of a 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<java.lang.Iterable<? extends E>> emptyIterable()
Creates a matcher for Iterables matching examined iterables that yield no items.

For example:

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


emptyIterableOf

public static <E> Matcher<java.lang.Iterable<E>> emptyIterableOf(java.lang.Class<E> type)
Creates a matcher for Iterables matching examined iterables that yield no items.

For example:

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

Parameters:
type - the type of the iterable's content