doc / ch.tutteli.atrium.api.fluent.en_GB / exactly

exactly

fun <T : CharSequence, S : CharSequenceContains.SearchBehaviour> CharSequenceContains.EntryPointStep<T, S>.exactly(times: Int): ExactlyCheckerStep<T, S>
fun <T : CharSequence, S : CharSequenceContains.SearchBehaviour> CharSequenceContains.Builder<T, S>.exactly(times: Int): ExactlyCheckerOption<T, S>

Restricts a contains assertion by specifying that the number of occurrences of the value which we are looking for occurs exactly number of times within the search input.

Parameters

times - The number which the check will compare against the actual number of times an expected value is found in the input of the search.

Exceptions

IllegalArgumentException - In case times is smaller than zero.

IllegalArgumentException - In case times equals to zero; use containsNot instead.

Return
The newly created builder.

fun <E, T : Iterable<E>, S : InAnyOrderSearchBehaviour> IterableContains.Builder<E, T, S>.exactly(times: Int): ExactlyCheckerOption<E, T, S>

Restricts a contains assertion by specifying that the number of occurrences of the entry which we are looking for occurs exactly number of times within the Iterable.

Parameters

times - The number which the check will compare against the actual number of times an expected entry is found in the Iterable.

Exceptions

IllegalArgumentException - In case times is smaller than zero.

IllegalArgumentException - In case times equals to zero; use containsNot instead.

Return
The newly created builder.

fun <E, T, S : InAnyOrderSearchBehaviour> IterableLikeContains.EntryPointStep<E, T, S>.exactly(times: Int): ExactlyCheckerStep<E, T, S>

Restricts a contains assertion by specifying that the number of occurrences of the entry which we are looking for occurs exactly number of times within the IterableLike.

Parameters

times - The number which the check will compare against the actual number of times an expected entry is found in the IterableLike.

Exceptions

IllegalArgumentException - In case times is smaller than zero.

IllegalArgumentException - In case times equals to zero; use containsNot instead.

Return
The newly created builder.

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