doc / ch.tutteli.atrium.api.infix.en_GB / toContainElementsOf

toContainElementsOf

inline infix fun <reified E, T : Iterable<E>> Expect<T>.toContainElementsOf(expectedIterableLike: IterableLike): Expect<T> (source)

Expects that the subject of this expectation (an Iterable) contains all elements of expectedIterableLike.

It is a shortcut for toContain.inAnyOrder.atLeast(1).elementsOf(expectedIterable)

Notice that a runtime check applies which assures that only Iterable, Sequence or one of the Array types are passed. This function expects IterableLike (which is a typealias for Any) to avoid cluttering the API.

expect(listOf(1, 2, 2, 4)) toContainElementsOf listOf(1, 2, 4)

fails {
    expect(listOf(1, 2, 2, 4)) toContainElementsOf listOf(1, 2, 3)
}

Parameters

expectedIterableLike - The IterableLike whose elements are expected to be contained within this Iterable.

Exceptions

IllegalArgumentException - in case expectedIterableLike is not an Iterable, Sequence or one of the Array types or the given expectedIterableLike does not have elements (is empty).

Return
an Expect for the subject of this expectation.

Since
0.17.0