org.hamcrest.collection
Class IsIterableWithSize<E>

java.lang.Object
  org.hamcrest.BaseMatcher<T>
      org.hamcrest.TypeSafeDiagnosingMatcher<T>
          org.hamcrest.FeatureMatcher<Iterable<E>,Integer>
              org.hamcrest.collection.IsIterableWithSize<E>

All Implemented Interfaces:

Matcher<Iterable<E>>, SelfDescribing

public class IsIterableWithSize<E>
extends FeatureMatcher<Iterable<E>,Integer>

Constructor Summary

IsIterableWithSize(Matcher<? super Integer> sizeMatcher)

Method Summary

protected Integer	featureValueOf(Iterable<E> actual)
static <E> Matcher<Iterable<E>>	iterableWithSize(int size) Creates a matcher for Iterables that matches when a single pass over the examined Iterable yields an item count that is equal to the specified size argument.
static <E> Matcher<Iterable<E>>	iterableWithSize(Matcher<? super Integer> sizeMatcher) Creates a matcher for Iterables that matches when a single pass over the examined Iterable yields an item count that satisfies the specified matcher.

Methods inherited from class org.hamcrest.FeatureMatcher

describeTo, matchesSafely

Methods inherited from class org.hamcrest.TypeSafeDiagnosingMatcher

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

IsIterableWithSize

public IsIterableWithSize(Matcher<? super Integer> sizeMatcher)

Method Detail

featureValueOf

protected Integer featureValueOf(Iterable<E> actual)

Specified by:

featureValueOf in class FeatureMatcher<Iterable<E>,Integer>

iterableWithSize

public static <E> Matcher<Iterable<E>> iterableWithSize(Matcher<? super Integer> sizeMatcher)

Creates a matcher for Iterables that matches when a single pass over the examined Iterable yields an item count that satisfies the specified matcher.

For example:

assertThat(Arrays.asList("foo", "bar"), iterableWithSize(equalTo(2)))

Parameters:

sizeMatcher - a matcher for the number of items that should be yielded by an examined Iterable

iterableWithSize

public static <E> Matcher<Iterable<E>> iterableWithSize(int size)

Creates a matcher for Iterables that matches when a single pass over the examined Iterable yields an item count that is equal to the specified size argument.

For example:

assertThat(Arrays.asList("foo", "bar"), iterableWithSize(2))

Parameters:

size - the number of items that should be yielded by an examined Iterable