Modifier and Type	Class and Description
private static class	IsIterableContainingInAnyOrder.Matching<S>

Modifier and Type	Field and Description
private final Collection<Matcher<? super T>>	matchers

Access	Constructor and Description
public	IsIterableContainingInAnyOrder(Collection<Matcher<? super T>> matchers)

Method Summary

Modifier and Type	Method and Description
public static <E> Matcher<Iterable<? extends E>>	containsInAnyOrder(final Matcher<? super E> the matcher that must be satisfied by the single item provided by an examined `Iterable` itemMatcher) Deprecated use contains(Matcher itemMatcher) instead Creates a matcher for `Iterable`s that matches when a single pass over the examined `Iterable` yields a single item that satisfies the specified matcher.
public static <T> Matcher<Iterable<? extends T>>	containsInAnyOrder(Matcher<? super T>... a list of matchers, each of which must be satisfied by an item provided by an examined `Iterable` itemMatchers) Creates an order agnostic matcher for `Iterable`s that matches when a single pass over the examined `Iterable` yields a series of items, each satisfying one matcher anywhere in the specified matchers.
public static <T> Matcher<Iterable<? extends T>>	containsInAnyOrder(T... the items that must equal the items provided by an examined `Iterable` in any order items) Creates an order agnostic matcher for `Iterable`s that matches when a single pass over the examined `Iterable` yields a series of items, each logically equal to one item anywhere in the specified items.
public static <T> Matcher<Iterable<? extends T>>	containsInAnyOrder(Collection<Matcher<? super T>> a list of matchers, each of which must be satisfied by an item provided by an examined `Iterable` itemMatchers) Creates an order agnostic matcher for `Iterable`s that matches when a single pass over the examined `Iterable` yields a series of items, each satisfying one matcher anywhere in the specified collection of matchers.
public void	describeTo(Description The description to be built or appended to. description) Implements org.hamcrest.SelfDescribing.describeTo. Generates a description of the object.
protected boolean	matchesSafely(Iterable<? extends T> items, Description mismatchDescription) Implements abstract org.hamcrest.TypeSafeDiagnosingMatcher.matchesSafely. Subclasses should implement this.

Inherited from org.hamcrest.TypeSafeDiagnosingMatcher:: describeMismatch matches

Field Detail

matchers	back to summary
private final Collection<Matcher<? super T>> matchers

Constructor Detail

IsIterableContainingInAnyOrder	back to summary
public IsIterableContainingInAnyOrder(Collection<Matcher<? super T>> matchers)

Method Detail

containsInAnyOrder back to summary

containsInAnyOrder	back to summary
public static <E> Matcher<Iterable<? extends E>> containsInAnyOrder(final Matcher<? super E> itemMatcher) Deprecated use contains(Matcher itemMatcher) instead Creates a matcher for `Iterable`s that matches when a single pass over the examined `Iterable` yields a single item that satisfies the specified matcher. For a positive match, the examined iterable must only yield one item. For example: assertThat(Arrays.asList("foo"), containsInAnyOrder(equalTo("foo"))) Parameters itemMatcher:Matcher<? super E> the matcher that must be satisfied by the single item provided by an examined `Iterable` Annotations @SuppressWarnings:unchecked @Deprecated @Factory

public static <E> Matcher<Iterable<? extends E>> containsInAnyOrder(final Matcher<? super E> itemMatcher)

Deprecated

use contains(Matcher itemMatcher) instead

Creates a matcher for Iterables that matches when a single pass over the examined Iterable yields a single item that satisfies the specified matcher. For a positive match, the examined iterable must only yield one item.

For example:

assertThat(Arrays.asList("foo"), containsInAnyOrder(equalTo("foo")))

Parameters

itemMatcher:Matcher<? super E>: the matcher that must be satisfied by the single item provided by an examined Iterable

Annotations

@SuppressWarnings:unchecked
@Deprecated
@Factory

containsInAnyOrder back to summary

containsInAnyOrder	back to summary
public static <T> Matcher<Iterable<? extends T>> containsInAnyOrder(Matcher<? super T>... itemMatchers) Creates an order agnostic matcher for `Iterable`s that matches when a single pass over the examined `Iterable` yields a series of items, each satisfying one matcher anywhere in the specified matchers. For a positive match, the examined iterable must be of the same length as the number of specified matchers. N.B. each of the specified matchers will only be used once during a given examination, so be careful when specifying matchers that may be satisfied by more than one entry in an examined iterable. For example: assertThat(Arrays.asList("foo", "bar"), containsInAnyOrder(equalTo("bar"), equalTo("foo"))) Parameters itemMatchers:Matcher<? super T>[] a list of matchers, each of which must be satisfied by an item provided by an examined `Iterable` Annotations @Factory

public static <T> Matcher<Iterable<? extends T>> containsInAnyOrder(Matcher<? super T>... itemMatchers)

Creates an order agnostic matcher for Iterables that matches when a single pass over the examined Iterable yields a series of items, each satisfying one matcher anywhere in the specified matchers. For a positive match, the examined iterable must be of the same length as the number of specified matchers.

N.B. each of the specified matchers will only be used once during a given examination, so be careful when specifying matchers that may be satisfied by more than one entry in an examined iterable.

For example:

assertThat(Arrays.asList("foo", "bar"), containsInAnyOrder(equalTo("bar"), equalTo("foo")))

Parameters

itemMatchers:Matcher<? super T>[]: a list of matchers, each of which must be satisfied by an item provided by an examined Iterable

Annotations

@Factory

containsInAnyOrder back to summary

containsInAnyOrder	back to summary
public static <T> Matcher<Iterable<? extends T>> containsInAnyOrder(T... items) Creates an order agnostic matcher for `Iterable`s that matches when a single pass over the examined `Iterable` yields a series of items, each logically equal to one item anywhere in the specified items. For a positive match, the examined iterable must be of the same length as the number of specified items. N.B. each of the specified items will only be used once during a given examination, so be careful when specifying items that may be equal to more than one entry in an examined iterable. For example: assertThat(Arrays.asList("foo", "bar"), containsInAnyOrder("bar", "foo")) Parameters items:T[] the items that must equal the items provided by an examined `Iterable` in any order Annotations @Factory

public static <T> Matcher<Iterable<? extends T>> containsInAnyOrder(T... items)

Creates an order agnostic matcher for Iterables that matches when a single pass over the examined Iterable yields a series of items, each logically equal to one item anywhere in the specified items. For a positive match, the examined iterable must be of the same length as the number of specified items.

N.B. each of the specified items will only be used once during a given examination, so be careful when specifying items that may be equal to more than one entry in an examined iterable.

For example:

assertThat(Arrays.asList("foo", "bar"), containsInAnyOrder("bar", "foo"))

Parameters

items:T[]: the items that must equal the items provided by an examined Iterable in any order

Annotations

@Factory

containsInAnyOrder back to summary

containsInAnyOrder	back to summary
public static <T> Matcher<Iterable<? extends T>> containsInAnyOrder(Collection<Matcher<? super T>> itemMatchers) Creates an order agnostic matcher for `Iterable`s that matches when a single pass over the examined `Iterable` yields a series of items, each satisfying one matcher anywhere in the specified collection of matchers. For a positive match, the examined iterable must be of the same length as the specified collection of matchers. N.B. each matcher in the specified collection will only be used once during a given examination, so be careful when specifying matchers that may be satisfied by more than one entry in an examined iterable. For example: assertThat(Arrays.asList("foo", "bar"), containsInAnyOrder(Arrays.asList(equalTo("bar"), equalTo("foo")))) Parameters itemMatchers:Collection<Matcher<? super T>> a list of matchers, each of which must be satisfied by an item provided by an examined `Iterable` Annotations @Factory

public static <T> Matcher<Iterable<? extends T>> containsInAnyOrder(Collection<Matcher<? super T>> itemMatchers)

Creates an order agnostic matcher for Iterables that matches when a single pass over the examined Iterable yields a series of items, each satisfying one matcher anywhere in the specified collection of matchers. For a positive match, the examined iterable must be of the same length as the specified collection of matchers.

N.B. each matcher in the specified collection will only be used once during a given examination, so be careful when specifying matchers that may be satisfied by more than one entry in an examined iterable.

For example:

assertThat(Arrays.asList("foo", "bar"), containsInAnyOrder(Arrays.asList(equalTo("bar"), equalTo("foo"))))

Parameters

itemMatchers:Collection<Matcher<? super T>>: a list of matchers, each of which must be satisfied by an item provided by an examined Iterable

Annotations

@Factory

describeTo	back to summary
public void describeTo(Description description) Implements org.hamcrest.SelfDescribing.describeTo. Doc from org.hamcrest.SelfDescribing.describeTo. 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:Description The description to be built or appended to. Annotations @Override

describeTo

back to summary

public void describeTo(Description description)

Implements org.hamcrest.SelfDescribing.describeTo.

Doc from org.hamcrest.SelfDescribing.describeTo.

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:Description: The description to be built or appended to.

Annotations

@Override

matchesSafely	back to summary
protected boolean matchesSafely(Iterable<? extends T> items, Description mismatchDescription) Implements abstract org.hamcrest.TypeSafeDiagnosingMatcher.matchesSafely. Doc from org.hamcrest.TypeSafeDiagnosingMatcher.matchesSafely. Subclasses should implement this. The item will already have been checked for the specific type and will never be null. Annotations @Override

matchesSafely

back to summary

protected boolean matchesSafely(Iterable<? extends T> items, Description mismatchDescription)

Implements abstract org.hamcrest.TypeSafeDiagnosingMatcher.matchesSafely.

Doc from org.hamcrest.TypeSafeDiagnosingMatcher.matchesSafely.

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

Annotations

@Override

org.hamcrest.collection back to summary

private Class IsIterableContainingInAnyOrder.Matching<S>

Class Inheritance

extends Object

java.lang.Object
org.hamcrest.collection.IsIterableContainingInAnyOrder.Matching

Field Summary

Modifier and Type	Field and Description
private final Collection<Matcher<? super S>>	matchers
private final Description	mismatchDescription

Constructor Summary

Access	Constructor and Description
public	Matching(Collection<Matcher<? super S>> matchers, Description mismatchDescription)

Method Summary

Modifier and Type	Method and Description
public boolean	isFinished(Iterable<? extends S> items)
private boolean	isMatched(S item)
private boolean	isNotSurplus(S item)
public boolean	matches(S item)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

matchers	back to summary
private final Collection<Matcher<? super S>> matchers

mismatchDescription	back to summary
private final Description mismatchDescription

Constructor Detail

Matching	back to summary
public Matching(Collection<Matcher<? super S>> matchers, Description mismatchDescription)

Method Detail

isFinished	back to summary
public boolean isFinished(Iterable<? extends S> items)

isMatched	back to summary
private boolean isMatched(S item)

isNotSurplus	back to summary
private boolean isNotSurplus(S item)

matches	back to summary
public boolean matches(S item)

public Class IsIterableContainingInAnyOrder<T>

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class IsIterableContainingInAnyOrder.Matching<S>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail