org.hamcrest.collection
Class IsArray<T>

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

public class IsArray<T>
extends org.hamcrest.TypeSafeMatcher<T[]>

Matcher for array whose elements satisfy a sequence of matchers. The array size must equal the number of element matchers.


Constructor Summary
IsArray(org.hamcrest.Matcher<? super T>[] elementMatchers)
           
 
Method Summary
static
<T> IsArray<T>
array(org.hamcrest.Matcher<? super T>... elementMatchers)
          Creates a matcher that matches arrays whose elements are satisfied by the specified matchers.
 void describeMismatchSafely(T[] actual, org.hamcrest.Description mismatchDescription)
           
 void describeTo(org.hamcrest.Description description)
           
protected  java.lang.String descriptionEnd()
          Returns the string that ends the description.
protected  java.lang.String descriptionSeparator()
          Returns the string that separates the elements in the description.
protected  java.lang.String descriptionStart()
          Returns the string that starts the description.
 boolean matchesSafely(T[] array)
           
 
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

IsArray

public IsArray(org.hamcrest.Matcher<? super T>[] elementMatchers)
Method Detail

matchesSafely

public boolean matchesSafely(T[] array)
Specified by:
matchesSafely in class org.hamcrest.TypeSafeMatcher<T[]>

describeMismatchSafely

public void describeMismatchSafely(T[] actual,
                                   org.hamcrest.Description mismatchDescription)
Overrides:
describeMismatchSafely in class org.hamcrest.TypeSafeMatcher<T[]>

describeTo

public void describeTo(org.hamcrest.Description description)

descriptionStart

protected java.lang.String descriptionStart()
Returns the string that starts the description. Can be overridden in subclasses to customise how the matcher is described.


descriptionSeparator

protected java.lang.String descriptionSeparator()
Returns the string that separates the elements in the description. Can be overridden in subclasses to customise how the matcher is described.


descriptionEnd

protected java.lang.String descriptionEnd()
Returns the string that ends the description. Can be overridden in subclasses to customise how the matcher is described.


array

public static <T> IsArray<T> array(org.hamcrest.Matcher<? super T>... elementMatchers)
Creates a matcher that matches arrays whose elements are satisfied by the specified matchers. Matches positively only if the number of matchers specified is equal to the length of the examined array and each matcher[i] is satisfied by array[i].

For example:

assertThat(new Integer[]{1,2,3}, is(array(equalTo(1), equalTo(2), equalTo(3))))

Parameters:
elementMatchers - the matchers that the elements of examined arrays should satisfy