org.hamcrest.collection
Class IsArrayContaining<T>

java.lang.Object
  extended by org.hamcrest.BaseMatcher<T>
      extended by org.hamcrest.TypeSafeMatcher<T[]>
          extended by org.hamcrest.collection.IsArrayContaining<T>
All Implemented Interfaces:
Matcher<T[]>, SelfDescribing

public class IsArrayContaining<T>
extends TypeSafeMatcher<T[]>

Matches if an array contains an item satisfying a nested matcher.


Constructor Summary
IsArrayContaining(Matcher<? super T> elementMatcher)
           
 
Method Summary
 void describeMismatchSafely(T[] item, Description mismatchDescription)
          Subclasses should override this.
 void describeTo(Description description)
          Generates a description of the object.
static
<T> Matcher<T[]>
hasItemInArray(Matcher<? super T> elementMatcher)
          Evaluates to true if any item in an array satisfies the given matcher.
static
<T> Matcher<T[]>
hasItemInArray(T element)
          This is a shortcut to the frequently used hasItemInArray(equalTo(x)).
 boolean matchesSafely(T[] array)
          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

IsArrayContaining

public IsArrayContaining(Matcher<? super T> elementMatcher)
Method Detail

matchesSafely

public boolean matchesSafely(T[] array)
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<T[]>

describeMismatchSafely

public void describeMismatchSafely(T[] item,
                                   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<T[]>

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.

hasItemInArray

public static <T> Matcher<T[]> hasItemInArray(Matcher<? super T> elementMatcher)
Evaluates to true if any item in an array satisfies the given matcher.


hasItemInArray

public static <T> Matcher<T[]> hasItemInArray(T element)
This is a shortcut to the frequently used hasItemInArray(equalTo(x)). For example, assertThat(hasItemInArray(equal_to(x))) vs. assertThat(hasItemInArray(x))