`fun <E : Any, T> IterableLikeContains.CheckerStep<out E?, T, InAnyOrderSearchBehaviour>.entries(assertionCreatorOrNull: (Expect<E>.() -> Unit)?, vararg otherAssertionCreatorsOrNulls: (Expect<E>.() -> Unit)?): Expect<T>`

(source)
Finishes the specification of the sophisticated `contains`

assertion where the subject (an IterableLike)
needs to contain an entry for assertionCreatorOrNull as well as for the otherAssertionCreatorsOrNulls
where it does not matter in which order they appear -- an entry is contained if it either
holds all assertions assertionCreatorOrNull creates or
needs to be `null`

in case assertionCreatorOrNull is defined as `null`

.

`assertionCreatorOrNull`

- The identification lambda which creates the assertions which the entry we are looking
for has to hold; or in other words, the function which defines whether an entry is the one we are looking for
or not. In case it is defined as `null`

, then an entry is identified if it is `null`

as well.

`otherAssertionCreatorsOrNulls`

- Additional identification lambdas which each identify (separately) an entry
which we are looking for (see assertionCreatorOrNull for more information).

**Return**

an Expect for the subject of `this`

expectation.

**Since**

0.14.0 -- API existed for Iterable but not for IterableLike.

`fun <E : Any, T> IterableLikeContains.EntryPointStep<out E?, T, InAnyOrderOnlySearchBehaviour>.entries(assertionCreatorOrNull: (Expect<E>.() -> Unit)?, vararg otherAssertionCreatorsOrNulls: (Expect<E>.() -> Unit)?): Expect<T>`

(source)
Finishes the specification of the sophisticated `contains`

assertion where the subject (an IterableLike)
needs to contain only an entry for assertionCreatorOrNull as well as for the otherAssertionCreatorsOrNulls
where it does not matter in which order they appear -- an entry is contained if it either
holds all assertions assertionCreatorOrNull creates or
needs to be `null`

in case assertionCreatorOrNull is defined as `null`

.

Notice, that a first-wins strategy applies which means your assertion creator lambdas -- which kind of serve as
identification lambdas -- should be ordered in such a way that the most specific identification lambda appears
first, not that a less specific lambda wins. For instance, given a `setOf(1, 2)`

you should not search for
`entries({ isGreaterThan(0) }, { toBe(1) })`

but for
`entries({ toBe(1) }, { isGreaterThan(0) })`

otherwise
`isGreaterThan(0)`

matches `1`

before `toBe(1)`

would match it. As a consequence `toBe(1)`

could only match the
entry which is left -- in this case `2`

-- and of course this would fail.

Note that we might change the signature of this function with the next version which will cause a binary backward compatibility break (see #292 for more information)

`assertionCreatorOrNull`

- The identification lambda which creates the assertions which the entry we are looking
for has to hold; or in other words, the function which defines whether an entry is the one we are looking for
or not. In case it is defined as `null`

, then an entry is identified if it is `null`

as well.

`otherAssertionCreatorsOrNulls`

- Additional identification lambdas which each identify (separately) an entry
which we are looking for (see assertionCreatorOrNull for more information).

**Return**

an Expect for the subject of `this`

expectation.

**Since**

0.14.0 -- API existed for Iterable but not for IterableLike.

`fun <E : Any, T> IterableLikeContains.EntryPointStep<out E?, T, InOrderOnlySearchBehaviour>.entries(assertionCreatorOrNull: (Expect<E>.() -> Unit)?, vararg otherAssertionCreatorsOrNulls: (Expect<E>.() -> Unit)?): Expect<T>`

(source)
Finishes the specification of the sophisticated `contains`

assertion where the subject (an IterableLike)
needs to contain only an entry for assertionCreatorOrNull as well as for the otherAssertionCreatorsOrNulls
in the specified order -- an entry is contained if it either
holds all assertions assertionCreatorOrNull creates or
needs to be `null`

in case assertionCreatorOrNull is defined as `null`

.

Note that we might change the signature of this function with the next version which will cause a binary backward compatibility break (see #292 for more information)

`assertionCreatorOrNull`

- The identification lambda which creates the assertions which the entry we are looking
for has to hold; or in other words, the function which defines whether an entry is the one we are looking for
or not. In case it is defined as `null`

, then an entry is identified if it is `null`

as well.

`otherAssertionCreatorsOrNulls`

- Additional identification lambdas which each identify (separately) an entry
which we are looking for (see assertionCreatorOrNull for more information).

**Return**

an Expect for the subject of `this`

expectation.

**Since**

0.14.0 -- API existed for Iterable but not for IterableLike.

`fun <K, V, T> MapLikeContains.EntryPointStep<K, V, T, InAnyOrderSearchBehaviour>.entries(keyValuePair: Pair<K, V>, vararg otherPairs: Pair<K, V>): Expect<T>`

(source)
Finishes the specification of the sophisticated `contains`

assertion where the subject (a MapLike)
needs to contain the given keyValuePair as well as the otherPairs where it does not matter
in which order they appear.

Notice, that it does not search for unique matches. Meaning, if the map is `mapOf('a' to 1)`

and keyValuePair is
defined as `'a' to 1`

and one of the otherPairs is defined as `'a' to 1`

as well, then both match,
even though they match the same entry.

**Return**

an Expect for the subject of `this`

expectation.

**Since**

0.15.0

`inline fun <K, reified V : Any, T> MapLikeContains.EntryPointStep<K, out V?, T, InAnyOrderSearchBehaviour>.entries(keyValue: KeyValue<K, V>, vararg otherKeyValues: KeyValue<K, V>): Expect<T>`

(source)
Finishes the specification of the sophisticated `contains`

assertion where the subject (a MapLike)
needs to contain the given keyValue as well as the otherKeyValues where it does not matter
in which order they appear -- an entry is contained if it has a key as defined by keyValue's KeyValue.key and
a corresponding value which either holds all assertions keyValue's
KeyValue.valueAssertionCreatorOrNull creates or needs to be `null`

in case
KeyValue.valueAssertionCreatorOrNull is defined as `null`

.

Notice, that it does not search for unique matches. Meaning, if the map is `mapOf('a' to 1)`

and keyValue is
defined as `Key('a') { isGreaterThan(0) }`

and one of the otherKeyValues is defined as `Key('a') { isLessThan(2) }`

, then both match, even though they match the same entry.

**Return**

an Expect for the subject of `this`

expectation.

**Since**

0.15.0

`fun <K, V, T> MapLikeContains.EntryPointStep<K, V, T, InAnyOrderOnlySearchBehaviour>.entries(keyValuePair: Pair<K, V>, vararg otherPairs: Pair<K, V>): Expect<T>`

(source)
Finishes the specification of the sophisticated `contains`

assertion where the subject (a MapLike)
needs to contain only the given keyValuePair as well as the otherPairs where it does not matter
in which order they appear.

**Return**

an Expect for the subject of `this`

expectation.

**Since**

0.15.0

`inline fun <K, reified V : Any, T> MapLikeContains.EntryPointStep<K, out V?, T, InAnyOrderOnlySearchBehaviour>.entries(keyValue: KeyValue<K, V>, vararg otherKeyValues: KeyValue<K, V>): Expect<T>`

(source)
Finishes the specification of the sophisticated `contains`

assertion where the subject (a MapLike)
needs to contain only the given keyValue as well as the otherKeyValues where it does not matter
in which order they appear -- an entry is contained if it has a key as defined by keyValue's KeyValue.key and
a corresponding value which either holds all assertions keyValue's
KeyValue.valueAssertionCreatorOrNull creates or needs to be `null`

in case
KeyValue.valueAssertionCreatorOrNull is defined as `null`

.

**Return**

an Expect for the subject of `this`

expectation.

**Since**

0.15.0

`fun <K, V, T> MapLikeContains.EntryPointStep<K, V, T, InOrderOnlySearchBehaviour>.entries(keyValuePair: Pair<K, V>, vararg otherPairs: Pair<K, V>): Expect<T>`

(source)
Finishes the specification of the sophisticated `contains`

assertion where the subject (a MapLike)
needs to contain only the given keyValuePair as well as the otherPairs in the specified order.

**Return**

an Expect for the subject of `this`

expectation.

**Since**

0.15.0

`inline fun <K, reified V : Any, T> MapLikeContains.EntryPointStep<K, out V?, T, InOrderOnlySearchBehaviour>.entries(keyValue: KeyValue<K, V>, vararg otherKeyValues: KeyValue<K, V>): Expect<T>`

(source)
Finishes the specification of the sophisticated `contains`

assertion where the subject (a MapLike)
needs to contain only the given keyValue as well as the otherKeyValues in the specified order -- an entry
is contained if it has a key as defined by keyValue's KeyValue.key and
a corresponding value which either holds all assertions keyValue's
KeyValue.valueAssertionCreatorOrNull creates or needs to be `null`

in case
KeyValue.valueAssertionCreatorOrNull is defined as `null`

.

**Return**

an Expect for the subject of `this`

expectation.

**Since**

0.15.0